HttpWebRequest.ConnectionGroupName プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
要求に対して使用する接続グループの名前を取得または設定します。
public:
virtual property System::String ^ ConnectionGroupName { System::String ^ get(); void set(System::String ^ value); };public override string? ConnectionGroupName { get; set; }public override string ConnectionGroupName { get; set; }member this.ConnectionGroupName : string with get, setPublic Overrides Property ConnectionGroupName As Stringプロパティ値
この要求に対して使用する接続グループの名前。 既定値は null です。
例
次のコード例は、ユーザー情報を使用して接続グループを形成する方法を示しています。変数 username、 passwordおよび domain このコードが呼び出される前にアプリケーションによって設定されていると仮定します。
// Create a secure group name.
// This example uses the SHA1 algorithm.
// Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
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();
// Create a secure group name.
// This example uses the SHA1 algorithm.
// Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
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();
' Create a secure group name.
' This example uses the SHA1 algorithm.
' Due to collision problems with SHA1, Microsoft recommends SHA256 or better.
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()
注釈
この ConnectionGroupName プロパティを使用すると、要求を接続グループに関連付けることができます。 これは、データベース サーバーから顧客情報を取得する Web サイトなど、アプリケーションが異なるユーザーに対して 1 つのサーバーに要求を行う場合に便利です。
注意 (継承者)
各接続グループは、サーバーに対して追加の接続を作成します。 これにより、そのサーバーのプロパティによって設定された接続の数を ConnectionLimit 超える可能性があります。