FtpWebRequest.ConnectionGroupName Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de naam op van de verbindingsgroep die het servicepunt bevat dat wordt gebruikt om de huidige aanvraag te verzenden.
public:
virtual property System::String ^ ConnectionGroupName { System::String ^ get(); void set(System::String ^ value); };public override string ConnectionGroupName { get; set; }member this.ConnectionGroupName : string with get, setPublic Overrides Property ConnectionGroupName As StringWaarde van eigenschap
Een String waarde die de naam van een verbindingsgroep bevat.
Uitzonderingen
Er is een nieuwe waarde opgegeven voor deze eigenschap voor een aanvraag die al wordt uitgevoerd.
Voorbeelden
In het volgende codevoorbeeld wordt de waarde van deze eigenschap opgehaald.
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
);
Opmerkingen
Verbindingsgroepen koppelen een set aanvragen aan een bepaalde verbinding of set verbindingen. De verbindingen in een verbindingsgroep kunnen alleen opnieuw worden gebruikt door aanvragen die afkomstig zijn uit hetzelfde toepassingsdomein, wanneer de referenties voor de aanvraag hetzelfde zijn en de aanvraag de naam van de verbindingsgroep opgeeft. Wanneer een aanvraag geen verbindingsgroepnaam opgeeft, kan een bestaande verbinding met de aangevraagde server die niet aan een verbindingsgroep is gekoppeld, worden gebruikt. Wanneer de referenties niet hetzelfde zijn, wordt de bestaande verbinding gesloten en moet de nieuwe aanvraag opnieuw worden geverifieerd.
Het gebruik van verbindingsgroepen kan de prestaties verbeteren omdat hierdoor alle aanvragen voor een gebruiker de geverifieerde verbinding opnieuw kunnen gebruiken met de referenties van de gebruiker.
Als u de ConnectionGroupName eigenschap wijzigt nadat de methode of de methode is BeginGetRequestStreamGetRequestStreamaangeroepen, GetResponseBeginGetResponse wordt er een InvalidOperationException uitzondering veroorzaakt.