FtpWebRequest.ConnectionGroupName Propriété

  • Référence

Définition

Espace de noms:
System.Net
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Source:
FtpWebRequest.cs
Source:
FtpWebRequest.cs
Source:
FtpWebRequest.cs

Obtient ou définit le nom du groupe de connexions contenant le point de service utilisé pour envoyer la demande actuelle.

public:
 virtual property System::String ^ ConnectionGroupName { System::String ^ get(); void set(System::String ^ value); };
public override string? ConnectionGroupName { get; set; }
public override string ConnectionGroupName { get; set; }
member this.ConnectionGroupName : string with get, set
Public Overrides Property ConnectionGroupName As String

Valeur de propriété

String

Valeur String contenant un nom de groupe de connexions.

Exceptions

InvalidOperationException

Une nouvelle valeur a été spécifiée pour cette propriété pour une demande qui est déjà en cours.

Exemples

L’exemple de code suivant récupère la valeur de cette propriété.

IWebProxy^ proxy = request->Proxy;
if ( proxy )
{
   Console::WriteLine( "Proxy: {0}", proxy->GetProxy( request->RequestUri ) );
}
else
{
   Console::WriteLine( "Proxy: (none)" );
}

Console::WriteLine( "ConnectionGroup: {0}", request->ConnectionGroupName == nullptr ? "none" : request->ConnectionGroupName );

IWebProxy proxy = request.Proxy;
if (proxy != null)
{
    Console.WriteLine("Proxy: {0}", proxy.GetProxy(request.RequestUri));
}
else
{
    Console.WriteLine("Proxy: (none)");
}

Console.WriteLine("ConnectionGroup: {0}",
    request.ConnectionGroupName == null ? "none" : request.ConnectionGroupName
);

Remarques

Les groupes de connexions associent un ensemble de requêtes à une connexion ou à un ensemble de connexions particulier. Les connexions d’un groupe de connexions peuvent être réutilisées uniquement par les demandes provenant du même domaine d’application, lorsque les informations d’identification sur la demande sont les mêmes et que la demande spécifie le nom du groupe de connexions. Lorsqu’une demande ne spécifie pas de nom de groupe de connexions, toute connexion existante au serveur demandé qui n’est pas associée à un groupe de connexions peut être utilisée. Lorsque les informations d’identification ne sont pas les mêmes, la connexion existante est fermée et la nouvelle demande doit être réauthentifiée.

L’utilisation de groupes de connexions peut améliorer les performances, car cela permet à toutes les demandes d’un utilisateur de réutiliser la connexion authentifiée avec les informations d’identification de l’utilisateur.

La modification de la ConnectionGroupName propriété après l’appel de la GetRequestStreamméthode , BeginGetRequestStream, GetResponseou BeginGetResponse provoque une InvalidOperationException exception.

S’applique à

Voir aussi