Condividi tramite


FtpWebRequest.ConnectionGroupName Proprietà

Definizione

Ottiene o imposta il nome del gruppo di connessione che contiene il punto di servizio usato per inviare la richiesta corrente.

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

Valore della proprietà

Valore String che contiene il nome di un gruppo di connessione.

Eccezioni

È stato specificato un nuovo valore per questa proprietà per una richiesta già in corso.

Esempio

Nell'esempio di codice seguente viene recuperato il valore di questa proprietà.

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

Commenti

I gruppi di connessioni associano un set di richieste a una determinata connessione o a un set di connessioni. Le connessioni in un gruppo di connessione possono essere riutilizzate solo dalle richieste che hanno origine nello stesso dominio applicazione, quando le credenziali nella richiesta sono uguali e la richiesta specifica il nome del gruppo di connessioni. Quando una richiesta non specifica un nome di gruppo di connessione, è possibile utilizzare qualsiasi connessione esistente al server richiesto non associato a un gruppo di connessione. Quando le credenziali non sono uguali, la connessione esistente viene chiusa e la nuova richiesta deve essere autenticata nuovamente.

L'uso dei gruppi di connessioni può migliorare le prestazioni perché consente a tutte le richieste di un utente di riutilizzare la connessione autenticata con le credenziali dell'utente.

La modifica della proprietà dopo la ConnectionGroupName chiamata al GetRequestStreammetodo , BeginGetRequestStream, GetResponseo BeginGetResponse causa un'eccezione InvalidOperationException .

Si applica a

Vedi anche