FtpWebRequest.ConnectionGroupName Eigenschaft

  • Referenz

Definition

Namespace:
System.Net
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Quelle:
FtpWebRequest.cs
Quelle:
FtpWebRequest.cs
Quelle:
FtpWebRequest.cs

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

String

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

Ausnahmen

InvalidOperationException

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 durch 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 alle Anforderungen für einen Benutzer die mit den Anmeldeinformationen des Benutzers authentifizierte Verbindung wiederverwenden können.

Das Ändern der ConnectionGroupName Eigenschaft nach dem Aufrufen der GetRequestStreamMethode , BeginGetRequestStream, GetResponseoder BeginGetResponse führt zu einer InvalidOperationException Ausnahme.

Gilt für:

Weitere Informationen