FtpWebRequest.ConnectionGroupName Vlastnost

Reference

Definice

Obor názvů:: System.Net

Sestavení:: System.Net.Requests.dll

Sestavení:: System.dll

Sestavení:: netstandard.dll

Zdroj:: FtpWebRequest.cs

Zdroj:: FtpWebRequest.cs

Zdroj:: FtpWebRequest.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

String

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

Výjimky

InvalidOperationException

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

Share via