HttpListener.Realm Eigenschaft

Definition

Namespace:

System.Net

Assembly:

System.Net.HttpListener.dll

Quelle:

HttpListener.cs

Ruft den Bereich oder die Ressourcenpartition ab, der bzw. die diesem HttpListener-Objekt zugeordnet ist, oder legt den Bereich bzw. die Partition fest.

public:
 property System::String ^ Realm { System::String ^ get(); void set(System::String ^ value); };

public string? Realm { get; set; }

member this.Realm : string with get, set

Public Property Realm As String

Eigenschaftswert

String

Ein String-Wert, der den Namen des dem HttpListener-Objekt zugeordneten Bereichs enthält.

Ausnahmen

ObjectDisposedException

Dieses Objekt wurde geschlossen.

Beispiele

Im folgenden Codebeispiel wird das Festlegen der Realm -Eigenschaft veranschaulicht.

public static void ConfigureListener1(HttpListener listener)
{
    // Specify an authentication realm.
    listener.Realm = "ExampleRealm";
}

Public Shared Sub ConfigureListener1(ByVal listener As HttpListener)
    ' Specify an authentication realm.
    listener.Realm = "ExampleRealm"
End Sub

Hinweise

Server verwenden Bereiche, um geschützte Ressourcen zu partitionieren. Jede Partition kann über ein eigenes Authentifizierungsschema und/oder eine eigene Autorisierungsdatenbank verfügen. Bereiche werden nur für die Standard- und Hashwertauthentifizierung verwendet. Nach der erfolgreichen Authentifizierung eines Clients ist die Authentifizierung für alle Ressourcen in einem bestimmten Bereich gültig. Eine ausführliche Beschreibung der Bereiche finden Sie unter RFC 2617 unter https://www.ietf.org/.

Eine Instanz von HttpListener verfügt nur über einen zugeordneten Bereich.