Export (0) Print
Expand All

HttpWebRequest.ConnectionGroupName Property

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

[Visual Basic]
Overrides Public Property ConnectionGroupName As String
[C#]
public override string ConnectionGroupName {get; set;}
[C++]
public: __property String* get_ConnectionGroupName();
public: __property void set_ConnectionGroupName(String*);
[JScript]
public override function get ConnectionGroupName() : String;
public override function set ConnectionGroupName(String);

Property Value

The name of the connection group for this request. The default value is a null reference (Nothing in Visual Basic).

Remarks

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 ServicePoint.ConnectionLimit for that server.

Example

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

[Visual Basic] 
' 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()
   

[C#] 
// Create a secure group name.
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();
    

[C++] 
// Create a secure group name.
SHA1Managed* Sha1 = new SHA1Managed();
Byte updHash[] = Sha1->ComputeHash(Encoding::UTF8->GetBytes(S"usernamepassworddomain"));
String* secureGroupName = Encoding::Default->GetString(updHash);

// Create a request for a specific URL.
WebRequest* myWebRequest=WebRequest::Create(S"http://www.contoso.com");

// Set the authentication credentials for the request.      
myWebRequest->Credentials = new NetworkCredential(S"username", S"password", S"domain"); 
myWebRequest->ConnectionGroupName = secureGroupName;

// Get the response.
WebResponse* myWebResponse=myWebRequest->GetResponse();

// Insert the code that uses myWebResponse here.

// Close the response.
myWebResponse->Close();
    

[JScript] 
//Create a WebRequest
var wReq : WebRequest = WebRequest.Create("http://www.contoso.com/")
       
// Set the Authentication credentials for the request.
wReq.Credentials = new NetworkCredential(username, password, domain)
// Assign the request to a connection group based on the user//s name
wReq.ConnectionGroupName = username
       
//Get the response
var wResp : WebResponse = wReq.GetResponse()

//Use the response and then close.
wResp.Close()

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework, Common Language Infrastructure (CLI) Standard

See Also

HttpWebRequest Class | HttpWebRequest Members | System.Net Namespace

Show:
© 2014 Microsoft