HttpWebRequest.ConnectionGroupName Свойство

Определение

Возвращает или задает имя группы подключения для запроса.Gets or sets the name of the connection group for the request.

public:
 virtual property System::String ^ ConnectionGroupName { System::String ^ get(); void set(System::String ^ value); };
public override string ConnectionGroupName { get; set; }
member this.ConnectionGroupName : string with get, set
Public Overrides Property ConnectionGroupName As String

Значение свойства

String

Имя группы подключения для данного запроса.The name of the connection group for this request. Значение по умолчанию — null.The default value is null.

Примеры

В следующем примере кода показано, как использовать сведения о пользователе для формирования группы соединений, предполагая, что переменные username , password и domain задаются приложением перед вызовом этого кода.The following code example show how to use user information to form a connection group, assuming that the variables username, password, and domain are set by the application before this code is called.

// Create a secure group name.
// This example uses the SHA1 algorithm.
// Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
SHA1Managed^ Sha1 = gcnew SHA1Managed;
array<Byte>^updHash = Sha1->ComputeHash( Encoding::UTF8->GetBytes( "usernamepassworddomain" ) );
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 = gcnew 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();
// 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();

' Create a secure group name.
' This example uses the SHA1 algorithm.
' Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
Dim Sha1 As New SHA1Managed()
Dim updHash As [Byte]() = Sha1.ComputeHash(Encoding.UTF8.GetBytes(("username" + "password" + "domain")))
Dim secureGroupName As [String] = Encoding.Default.GetString(updHash)
   
' Create a request for a specific URL.
Dim myWebRequest As WebRequest = 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.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
   
' Insert the code that uses myWebResponse here.
' Close the response.
myWebResponse.Close()
   

Комментарии

ConnectionGroupNameСвойство позволяет связать запрос с группой соединений.The ConnectionGroupName property enables you to associate a request with a connection group. Это полезно, когда приложение выполняет запросы к одному серверу для разных пользователей, например веб-сайт, который получает сведения о клиентах с сервера базы данных.This is useful when your application makes requests to one server for different users, such as a Web site that retrieves customer information from a database server.

Примечания для тех, кто наследует этот метод

Каждая группа соединений создает дополнительные соединения для сервера.Each connection group creates additional connections for a server. Это может привести к превышению числа подключений, заданных ConnectionLimit свойством для этого сервера.This may result in exceeding the number of connections set by the ConnectionLimit property for that server.

Применяется к

См. также раздел