FtpWebRequest.ConnectionGroupName Свойство

Определение

Возвращает или задает имя группы подключения, которая содержит точку обслуживания, используемую для отправки текущего запроса.Gets or sets the name of the connection group that contains the service point used to send the current request.

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, которое содержит имя группы подключения.A String value that contains a connection group name.

Исключения

Для этого свойства задано новое значение для уже выполняющегося запроса.A new value was specified for this property for a request that is already in progress.

Примеры

В следующем примере кода извлекается значение этого свойства.The following code example retrieves the value of this property.

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
);

Комментарии

Группы соединений связывают набор запросов с определенным соединением или набором соединений.Connection groups associate a set of requests with a particular connection or set of connections. Соединения в группе соединений могут повторно использоваться только запросами, происходящими в том же домене приложения, если учетные данные запроса совпадают, а запрос указывает имя группы соединения.The connections in a connection group can be reused only by requests originating in the same application domain, when the credentials on the request are the same and the request specifies the connection group name. Если в запросе не указано имя группы подключения, можно использовать любое существующее подключение к запрошенному серверу, не связанное с группой соединений.When a request does not specify a connection group name, any existing connection to the requested server that is not associated with a connection group can be used. Если учетные данные не совпадают, существующее соединение закрывается, а новый запрос должен пройти повторную проверку подлинности.When the credentials are not the same, the existing connection is closed and the new request must be reauthenticated.

Использование групп соединений может повысить производительность, так как это позволяет всем запросам пользователя повторно использовать подключение, прошедшее проверку подлинности с учетными данными пользователя.Using connection groups can improve performance because this allows all of the requests for a user to reuse the connection authenticated with the user's credentials.

Изменение свойства ConnectionGroupName после вызова метода GetRequestStream, BeginGetRequestStream, GetResponseили BeginGetResponse вызывает исключение InvalidOperationException.Changing the ConnectionGroupName property after calling the GetRequestStream, BeginGetRequestStream, GetResponse, or BeginGetResponse method causes an InvalidOperationException exception.

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

Дополнительно