FtpWebRequest.ConnectionGroupName Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает имя группы подключения, которая содержит точку обслуживания, используемую для отправки текущего запроса.
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 StringЗначение свойства
Значение String, которое содержит имя группы подключения.
Исключения
Для этого свойства задано новое значение для уже выполняющегося запроса.
Примеры
В следующем примере кода извлекается значение этого свойства.
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
);
Комментарии
Группы соединений связывают набор запросов с определенным соединением или набором подключений. Подключения в группе подключений могут повторно использоваться только запросами, исходящими из того же домена приложения, если учетные данные в запросе совпадают, а в запросе указано имя группы подключений. Если в запросе не указано имя группы подключений, можно использовать любое существующее подключение к запрашиваемому серверу, не связанное с группой подключений. Если учетные данные не совпадают, существующее подключение закрывается и новый запрос должен пройти повторную проверку подлинности.
Использование групп соединений может повысить производительность, так как это позволяет всем запросам пользователя повторно использовать подключение, прошедшее проверку подлинности с учетными данными пользователя.
ConnectionGroupName Изменение свойства после вызова GetRequestStreamметода , BeginGetRequestStream, GetResponseили BeginGetResponse вызывает InvalidOperationException исключение.
