FtpWebRequest.ConnectionGroupName Vlastnost
Definice
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, setPublic Overrides Property ConnectionGroupName As StringHodnota vlastnosti
String Hodnota, která obsahuje název skupiny připojení.
Výjimky
Pro tuto vlastnost byla zadána nová hodnota 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 != 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ů k určitému připojení nebo sadě připojení. Připojení ve skupině připojení je možné znovu použít pouze 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í, můžete použít jakékoli existující připojení k požadovanému serveru, který není přidružený ke skupině připojení. Pokud přihlašovací údaje nejsou stejné, stávající připojení se zavře a nový požadavek se musí znovu vytvořit.
Použití skupin připojení může zvýšit výkon, protože to umožňuje všem požadavkům uživatele opakovaně používat připojení ověřené pomocí přihlašovacích údajů uživatele.
ConnectionGroupName Změna vlastnosti po volání GetRequestStream, BeginGetRequestStream, GetResponsenebo BeginGetResponse metoda způsobí InvalidOperationException výjimku.
