FtpWebRequest.ConnectionGroupName Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o nome do grupo de ligação que contém o ponto de serviço usado para enviar o pedido 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 de Propriedade
Um String valor que contém o nome de um grupo de ligação.
Exceções
Foi especificado um novo valor para esta propriedade para um pedido que já está em curso.
Exemplos
O seguinte exemplo de código recupera o valor desta 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
);
Observações
Os grupos de ligações associam um conjunto de pedidos a uma ligação ou conjunto específico de ligações. As ligações num grupo de ligação só podem ser reutilizadas por pedidos originados no mesmo domínio de aplicação, quando as credenciais do pedido são as mesmas e o pedido especifica o nome do grupo de ligação. Quando um pedido não especifica um nome de grupo de ligação, qualquer ligação existente ao servidor solicitado que não esteja associada a um grupo de ligação pode ser utilizada. Quando as credenciais não são as mesmas, a ligação existente é encerrada e o novo pedido deve ser reautenticado.
A utilização de grupos de ligação pode melhorar o desempenho porque permite que todos os pedidos de um utilizador reutilizem a ligação autenticada com as credenciais do utilizador.
Alterar a ConnectionGroupName propriedade após chamar o GetRequestStream, BeginGetRequestStream, GetResponse, ou BeginGetResponse método causa uma InvalidOperationException exceção.
