HttpWebRequest.ConnectionGroupName プロパティ
要求に対して使用する接続グループの名前を取得または設定します。
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);
プロパティ値
この要求に対して使用する接続グループの名前。既定値は null 参照 (Visual Basic では Nothing) です。
解説
ConnectionGroupName プロパティを使用すると、要求を接続グループに関連付けることができます。これは、データベース サーバーから顧客情報を取得する Web サイトのように、アプリケーションが複数のユーザーのために 1 つのサーバーに要求を行う場合に役立ちます。
実装時の注意: 接続グループごとに、サーバーへの追加の接続が確立されます。これにより、サーバーの ServicePoint.ConnectionLimit を超過することがあります。
使用例
ユーザー情報を使用して接続グループを生成する例を次に示します。なお、この例では、このコードが呼び出される前にアプリケーションによって username 、 password 、および domain が設定済みであることを想定しています。
' 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("https://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("https://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"https://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("https://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()
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard