HttpWebRequest.ConnectionGroupName-Eigenschaft

Ruft den Namen der Verbindungsgruppe für die Anforderung ab oder legt diesen fest.

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

Syntax

'Declaration
Public Overrides Property ConnectionGroupName As String
'Usage
Dim instance As HttpWebRequest
Dim value As String

value = instance.ConnectionGroupName

instance.ConnectionGroupName = value

public override string ConnectionGroupName { get; set; }

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

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

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

public override function get ConnectionGroupName () : String

public override function set ConnectionGroupName (value : String)

Eigenschaftenwert

Der Name der Verbindungsgruppe für diese Anforderung. Der Standardwert ist NULL (Nothing in Visual Basic).

Hinweise

Mit der ConnectionGroupName-Eigenschaft können Sie eine Anforderung einer Verbindungsgruppe zuordnen. Dies ist nützlich, wenn eine Anwendung Anforderungen für verschiedene Benutzer an einen Server sendet, z. B. eine Website, die Kundendaten von einem Datenbankserver abruft.

Hinweise für Implementierer Jede Verbindungsgruppe erstellt zusätzliche Verbindungen für einen Server. Dies kann dazu führen, dass die Anzahl der von der ServicePoint.ConnectionLimit-Eigenschaft für diesen Server festgelegten Verbindungen überschritten wird.

Beispiel

Im folgenden Codebeispiel wird die Verwendung von Benutzerinformationen zum Einrichten einer Verbindungsgruppe veranschaulicht, wobei davon ausgegangen wird, dass die Variablen username, password und domain vor dem Aufrufen des Codes von der Anwendung festgelegt werden.

' 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()
   

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

// 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( "https://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.
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("https://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();

//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()

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

HttpWebRequest-Klasse
HttpWebRequest-Member
System.Net-Namespace