HttpWebRequest.ConnectionGroupName プロパティ

.NET Framework クラス ライブラリ リファレンス

HttpWebRequest.ConnectionGroupName プロパティ

要求に対して使用する接続グループの名前を取得または設定します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Overrides Property
 ConnectionGroupName As String

Visual Basic (使用法)

Dim instance As HttpWebRequest
Dim value As String

value = instance.ConnectionGroupName

instance.ConnectionGroupName = value

C#

public override string ConnectionGroupName
 { get; set; }

C++

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

J#

/** @property */
public String get_ConnectionGroupName ()

/** @property */
public void set_ConnectionGroupName (String
 value)

JScript

public override function get
 ConnectionGroupName () : String

public override function set
 ConnectionGroupName (value : String)

プロパティ値
この要求に対して使用する接続グループの名前。既定値は null 参照 (Visual Basic では Nothing) です。

解説

ConnectionGroupName プロパティを使用すると、要求を接続グループに関連付けることができます。これは、データベース サーバーから顧客情報を取得する Web サイトのように、アプリケーションが複数のユーザーのために 1 つのサーバーに要求を行う場合に役立ちます。

実装時の注意 接続グループごとに、サーバーへの追加の接続が確立されます。これにより、そのサーバーの ServicePoint.ConnectionLimit プロパティで設定された接続数を超過することがあります。

使用例

ユーザー情報を使用して接続グループを生成するコード例を次に示します。この例では、このコードが呼び出される前にアプリケーションによって username、password、および domain が設定済みであることを想定しています。

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

J#

// Create a secure group name.
SHA1Managed sha1 = new SHA1Managed();
ubyte updHash[] = sha1.ComputeHash(Encoding.get_UTF8().
    GetBytes(("username" + "password" + "domain")));
String secureGroupName = Encoding.get_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.set_Credentials(new NetworkCredential("username",
 
    "password", "domain"));
myWebRequest.set_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()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
HttpWebRequest クラス
HttpWebRequest メンバ
System.Net 名前空間