FtpWebRequest.ConnectionGroupName Свойство

Определение

Пространство имен:

System.Net

Сборка:

System.Net.Requests.dll

Исходный код:

FtpWebRequest.cs

Возвращает или задает имя группы подключения, которая содержит точку обслуживания, используемую для отправки текущего запроса.

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, set

Public Overrides Property ConnectionGroupName As String

Значение свойства

String

Значение String, которое содержит имя группы подключения.

Исключения

InvalidOperationException

Для этого свойства задано новое значение для уже выполняющегося запроса.

Примеры

В следующем примере кода извлекается значение этого свойства.

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

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

• FtpWebResponse
• FtpStatusCode
• WebRequestMethods.Ftp
• WebRequest
• WebResponse
• WebClient
• Управление подключениями