FtpWebRequest.ConnectionGroupName Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Overrides Property ConnectionGroupName As StringEigenschaftswert
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.
