HttpWebRequest.ConnectionGroupName Propriedade

Definição

Obtém ou define o nome do grupo de conexões para a solicitação.

public override string? ConnectionGroupName { get; set; }
public override string ConnectionGroupName { get; set; }

Valor da propriedade

O nome do grupo de conexões para essa solicitação. O valor padrão é null.

Exemplos

O exemplo de código a seguir mostra como usar informações do usuário para formar um grupo de conexões, supondo que as variáveis username, passworde domain sejam definidas pelo aplicativo antes que esse código seja chamado.

// Create a secure group name.
// This example uses the SHA1 algorithm.
// Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
SHA1Managed Sha1 = new SHA1Managed();
Byte[] updHash = Sha1.ComputeHash(Encoding.UTF8.GetBytes("username" + "password" +  "domain"));
String secureGroupName = Encoding.Default.GetString(updHash);

// Create a request for a specific URL.
WebRequest myWebRequest=WebRequest.Create("http://www.contoso.com");

// Set the authentication credentials for the request.
myWebRequest.Credentials = new NetworkCredential("username", "password", "domain");
myWebRequest.ConnectionGroupName = secureGroupName;

// Get the response.
WebResponse myWebResponse=myWebRequest.GetResponse();

// Insert the code that uses myWebResponse here.

// Close the response.
myWebResponse.Close();

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

A propriedade ConnectionGroupName permite associar uma solicitação a um grupo de conexões. Isso é útil quando seu aplicativo faz solicitações a um servidor para usuários diferentes, como um site que recupera informações do cliente de um servidor de banco de dados.

Notas aos Herdeiros

Cada grupo de conexões cria conexões adicionais para um servidor. Isso pode resultar em exceder o número de conexões definidas pela propriedade ConnectionLimit para esse servidor.

Aplica-se a

Confira também