HttpWebRequest::ConnectionGroupName Property


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

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

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

Property Value

Type: System::String^

The name of the connection group for this request. The default value is null.

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( "" );

// 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
Available since 1.1
Return to top