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.Gets or sets the name of the connection group that contains the service point used to send the current request.

public:
 virtual property System::String ^ ConnectionGroupName { System::String ^ get(); void set(System::String ^ value); };
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.A String value that contains a connection group name.

Ausnahmen

Für diese Eigenschaft wurde ein neuer Wert für eine Anforderung angegeben, die bereits ausgeführt wird.A new value was specified for this property for a request that is already in progress.

Beispiele

Im folgenden Codebeispiel wird der Wert dieser Eigenschaft abgerufen.The following code example retrieves the value of this property.

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

Verbindungs Gruppen ordnen eine Reihe von Anforderungen einer bestimmten Verbindung oder einer Gruppe von Verbindungen zu.Connection groups associate a set of requests with a particular connection or set of connections. Die Verbindungen in einer Verbindungsgruppe können nur von Anforderungen wieder verwendet werden, die in derselben Anwendungsdomäne stammen, wenn die Anmelde Informationen für die Anforderung identisch sind und die Anforderung den Verbindungs Gruppennamen angibt.The connections in a connection group can be reused only by requests originating in the same application domain, when the credentials on the request are the same and the request specifies the connection group name. Wenn eine Anforderung keinen Verbindungs Gruppennamen angibt, können alle vorhandenen Verbindungen mit dem angeforderten Server, der keiner Verbindungsgruppe zugeordnet ist, verwendet werden.When a request does not specify a connection group name, any existing connection to the requested server that is not associated with a connection group can be used. Wenn die Anmelde Informationen nicht identisch sind, wird die vorhandene Verbindung geschlossen, und die neue Anforderung muss erneut authentifiziert werden.When the credentials are not the same, the existing connection is closed and the new request must be reauthenticated.

Die Verwendung von Verbindungs Gruppen kann die Leistung verbessern, da dadurch alle Anforderungen eines Benutzers die Wiederverwendbarkeit der mit den Anmelde Informationen des Benutzers authentifizierten Verbindung wieder verwenden können.Using connection groups can improve performance because this allows all of the requests for a user to reuse the connection authenticated with the user's credentials.

Wenn Sie die ConnectionGroupName-Eigenschaft nach dem Aufrufen der Methoden GetRequestStream, BeginGetRequestStream, GetResponseoder BeginGetResponse ändern, wird eine InvalidOperationException Ausnahme ausgelöst.Changing the ConnectionGroupName property after calling the GetRequestStream, BeginGetRequestStream, GetResponse, or BeginGetResponse method causes an InvalidOperationException exception.

Gilt für:

Siehe auch