HttpWebRequest.ConnectionGroupName Eigenschaft

  • Referenz

Definition

Namespace:
System.Net
Assembly:
System.Net.Requests.dll
Assembly:
System.dll
Assembly:
netstandard.dll

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

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, set
Public Overrides Property ConnectionGroupName As String

Eigenschaftswert

String

Der Name der Verbindungsgruppe für diese Anforderung. Der Standardwert ist null.

Beispiele

Das folgende Codebeispiel zeigt, wie Benutzerinformationen zum Erstellen einer Verbindungsgruppe verwendet werden, vorausgesetzt, dass die Variablen username, passwordund domain von der Anwendung festgelegt werden, bevor dieser Code aufgerufen wird.

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

Hinweise

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

Hinweise für Vererber

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

Gilt für

Siehe auch