Partager via


FtpWebRequest.ConnectionGroupName Propriété

Définition

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é

Valeur String contenant un nom de groupe de connexions.

Exceptions

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 particulière ou à un ensemble de connexions. Les connexions d’un groupe de connexions ne peuvent être réutilisées que par les requêtes provenant du même domaine d’application, lorsque les informations d’identification de la demande sont identiques et que la demande spécifie le nom du groupe de connexions. Lorsqu’une requête 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