Udostępnij za pośrednictwem


FtpWebRequest.ConnectionGroupName Właściwość

Definicja

Pobiera lub ustawia nazwę grupy połączeń, która zawiera punkt usługi używany do wysyłania bieżącego żądania.

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

Wartość właściwości

String Wartość zawierająca nazwę grupy połączeń.

Wyjątki

Dla tej właściwości określono nową wartość dla żądania, które jest już w toku.

Przykłady

Poniższy przykład kodu pobiera wartość tej właściwości.

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

Uwagi

Grupy połączeń kojarzą zestaw żądań z określonym połączeniem lub zestawem połączeń. Połączenia w grupie połączeń mogą być ponownie używane tylko przez żądania pochodzące z tej samej domeny aplikacji, gdy poświadczenia w żądaniu są takie same, a żądanie określa nazwę grupy połączeń. Jeśli żądanie nie określa nazwy grupy połączeń, można użyć żadnego istniejącego połączenia z żądanym serwerem, które nie jest skojarzone z grupą połączeń. Jeśli poświadczenia nie są takie same, istniejące połączenie zostanie zamknięte i nowe żądanie musi zostać ponownie uwierzytelnione.

Użycie grup połączeń może zwiększyć wydajność, ponieważ umożliwia to wszystkim żądaniom użytkownika ponowne użycie połączenia uwierzytelnionego przy użyciu poświadczeń użytkownika.

ConnectionGroupName Zmiana właściwości po wywołaniu GetRequestStreammetody , BeginGetRequestStream, GetResponselub BeginGetResponse powoduje InvalidOperationException wyjątek.

Dotyczy

Zobacz też