FtpWebRequest.ConnectionGroupName Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Overrides Property ConnectionGroupName As StringValor 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.
