Freigeben über


FtpWebRequest.ConnectionGroupName Eigenschaft

Definition

Ruft den Namen der Verbindungsgruppe ab, die den zum Senden der aktuellen Anforderung verwendeten Dienstpunkt enthält, oder legt diesen fest.

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

Eigenschaftswert

Ein String-Wert, der einen Verbindungsgruppennamen enthält.

Ausnahmen

Für diese Eigenschaft wurde ein neuer Wert für eine Anforderung angegeben, die bereits ausgeführt wird.

Beispiele

Im folgenden Codebeispiel wird der Wert dieser Eigenschaft abgerufen.

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
);

Hinweise

Verbindungsgruppen ordnen eine Reihe von Anforderungen einer bestimmten Verbindung oder einer bestimmten Gruppe von Verbindungen zu. Die Verbindungen in einer Verbindungsgruppe können nur von Anforderungen wiederverwendet werden, die aus derselben Anwendungsdomäne stammen, wenn die Anmeldeinformationen für die Anforderung identisch sind und die Anforderung den Namen der Verbindungsgruppe angibt. Wenn eine Anforderung keinen Verbindungsgruppennamen angibt, kann jede vorhandene Verbindung mit dem angeforderten Server verwendet werden, die keiner Verbindungsgruppe zugeordnet ist. Wenn die Anmeldeinformationen nicht identisch sind, wird die vorhandene Verbindung geschlossen, und die neue Anforderung muss erneut authentifiziert werden.

Die Verwendung von Verbindungsgruppen kann die Leistung verbessern, da dadurch alle Anforderungen an einen Benutzer die mit den Anmeldeinformationen des Benutzers authentifizierte Verbindung wiederverwenden können.

Das Ändern der ConnectionGroupName -Eigenschaft nach dem Aufrufen der GetRequestStream- , BeginGetRequestStreamGetResponse- oder BeginGetResponse -Methode verursacht eine InvalidOperationException Ausnahme.

Gilt für:

Weitere Informationen