Sdílet prostřednictvím


FtpWebRequest.ConnectionGroupName Vlastnost

Definice

Získá nebo nastaví název skupiny připojení, která obsahuje bod služby použitý k odeslání aktuálního požadavku.

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

Hodnota vlastnosti

Hodnota String , která obsahuje název skupiny připojení.

Výjimky

Byla zadána nová hodnota pro tuto vlastnost pro požadavek, který již probíhá.

Příklady

Následující příklad kódu načte hodnotu této vlastnosti.

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

Poznámky

Skupiny připojení přidružují sadu požadavků ke konkrétnímu připojení nebo sadě připojení. Připojení ve skupině připojení můžou opakovaně používat jenom požadavky pocházející ze stejné domény aplikace, pokud jsou přihlašovací údaje v požadavku stejné a požadavek určuje název skupiny připojení. Pokud požadavek nezadá název skupiny připojení, lze použít všechna existující připojení k požadovanému serveru, které není přidruženo ke skupině připojení. Pokud přihlašovací údaje nejsou stejné, stávající připojení se ukončí a nový požadavek se musí znovu ověřovat.

Použití skupin připojení může zvýšit výkon, protože to umožňuje, aby všechny požadavky na uživatele opakovaně používaly připojení ověřené pomocí přihlašovacích údajů uživatele.

ConnectionGroupName Změna vlastnosti po volání GetRequestStreammetody , BeginGetRequestStream, GetResponsenebo BeginGetResponse způsobí InvalidOperationException výjimku.

Platí pro

Viz také