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.
Dient zum Abrufen oder Festlegen des Namens der Verbindungsgruppe, die den Dienstpunkt enthält, der zum Senden der aktuellen Anforderung verwendet wird.
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 Bereits ausgeführte Anforderung angegeben.
Beispiele
Im folgenden Codebeispiel wird der Wert dieser Eigenschaft abgerufen.
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 in 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 eine vorhandene Verbindung mit dem angeforderten Server verwendet werden, der 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 für einen Benutzer die mit den Anmeldeinformationen des Benutzers authentifizierte Verbindung wiederverwenden können.
Das Ändern der Eigenschaft nach dem Aufrufen der ConnectionGroupNameGetRequestStream, BeginGetRequestStream, , GetResponseoder BeginGetResponse Methode verursacht eine InvalidOperationException Ausnahme.
