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ões 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 String valor que contém um nome de grupo de conexão.
Exceções
Um novo valor foi especificado para essa propriedade para uma solicitação que já está em andamento.
Exemplos
O exemplo de código a seguir recupera o valor dessa propriedade.
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 determinada conexão ou 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 esteja associada a um grupo de conexões 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 , BeginGetRequestStream, GetResponseou BeginGetResponse causa uma exceção InvalidOperationException .
