FtpWebRequest.ConnectionGroupName Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Overrides Property ConnectionGroupName As StringValore 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 .
