Compartilhar via


FtpWebRequest.ConnectionGroupName Propriedade

Definição

Obtém ou define o nome do grupo de conexão que contém o ponto de serviço usado para enviar a solicitação atual.

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

Valor da propriedade

Um valor String que contém o nome de um grupo de conexão.

Exceções

Um novo valor foi especificado para essa propriedade referente a uma solicitação já em andamento.

Exemplos

O exemplo de código a seguir recupera o valor dessa propriedade.

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

Comentários

Os grupos de conexões associam um conjunto de solicitações a uma conexão específica ou um conjunto de conexões. As conexões em um grupo de conexões só podem ser reutilizados por solicitações originadas no mesmo domínio do aplicativo, quando as credenciais na solicitação são as mesmas e a solicitação especifica o nome do grupo de conexões. Quando uma solicitação não especifica um nome de grupo de conexão, qualquer conexão existente com o servidor solicitado que não está associada a um grupo de conexão pode ser usada. Quando as credenciais não são as mesmas, a conexão existente é fechada e a nova solicitação deve ser autenticada novamente.

O uso de grupos de conexões pode melhorar o desempenho porque isso permite que todas as solicitações de um usuário reutilizem a conexão autenticada com as credenciais do usuário.

Alterar a ConnectionGroupName propriedade depois de chamar o GetRequestStreammétodo , BeginGetRequestStreamGetResponse, ou BeginGetResponse causa uma exceçãoInvalidOperationException.

Aplica-se a

Confira também