Export (0) Print
Expand All

HttpWebRequest::ConnectionGroupName Property

Gets or sets the name of the connection group for the request.

Namespace:  System.Net
Assembly:  System (in System.dll)

virtual property String^ ConnectionGroupName {
	String^ get () override;
	void set (String^ value) override;

Property Value

Type: System::String
The name of the connection group for this request. The default value is nullptr.

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.

Notes to Implementers

Each connection group creates additional connections for a server. This may result in exceeding the number of connections set by the ServicePoint::ConnectionLimit property for that server.

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.
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.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
© 2015 Microsoft