HttpWebRequest::ConnectionGroupName Property
Gets or sets the name of the connection group for the request.
Assembly: System (in System.dll)
public: 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( "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();
Available since 1.1