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, set
Public 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 исключение.

Применяется к

См. также раздел