HttpWebRequest.ConnectionGroupName Property

.NET Framework (current version)

Note
The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

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

Syntax

C++

Public Overrides Property ConnectionGroupName As String

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.

Examples

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.

C++

' Create a secure group name.
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()

Version Information

.NET Framework
Available since 1.1