FtpWebRequest.ConnectionGroupName Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Net
Zestaw:
System.Net.Requests.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll

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

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

Wyjątki

InvalidOperationException

Określono nową wartość dla tej właściwości 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óry nie jest skojarzony z grupą połączeń. Jeśli poświadczenia nie są takie same, istniejące połączenie jest zamknięte, a 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ż