FtpWebRequest.ConnectionGroupName Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger namnet på den anslutningsgrupp som innehåller den tjänstpunkt som används för att skicka den aktuella begäran.
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 StringEgenskapsvärde
Ett String värde som innehåller ett namn på en anslutningsgrupp.
Undantag
Ett nytt värde har angetts för den här egenskapen för en begäran som redan pågår.
Exempel
Följande kodexempel hämtar värdet för den här egenskapen.
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
);
Kommentarer
Anslutningsgrupper associerar en uppsättning begäranden med en viss anslutning eller uppsättning anslutningar. Anslutningarna i en anslutningsgrupp kan endast återanvändas av begäranden som kommer från samma programdomän, när autentiseringsuppgifterna för begäran är desamma och begäran anger anslutningsgruppens namn. När en begäran inte anger ett namn på en anslutningsgrupp kan alla befintliga anslutningar till den begärda servern som inte är associerade med en anslutningsgrupp användas. När autentiseringsuppgifterna inte är desamma stängs den befintliga anslutningen och den nya begäran måste autentiseras igen.
Användning av anslutningsgrupper kan förbättra prestanda eftersom det gör att alla begäranden för en användare kan återanvända anslutningen som autentiseras med användarens autentiseringsuppgifter.
ConnectionGroupName Att ändra egenskapen efter att ha anropat GetRequestStreammetoden , BeginGetRequestStream, GetResponseeller BeginGetResponse orsakar ett InvalidOperationException undantag.
