HttpListener.Realm Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.HttpListener.dll

Source:

HttpListener.cs

Obtient ou définit le domaine, ou partition de ressource, associé à cet objet HttpListener.

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

Valeur de propriété

String

Valeur String contenant le nom du domaine associé à l'objet HttpListener.

Exceptions

ObjectDisposedException

L’objet a été fermé.

Exemples

L’exemple de code suivant illustre la définition de la Realm propriété .

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

Remarques

Les serveurs utilisent des domaines pour partitionner des ressources protégées ; chaque partition peut avoir son propre schéma d’authentification et/ou sa propre base de données d’autorisation. Les domaines sont utilisés uniquement pour les authentifications Digest et de base. Lorsqu'un client est correctement authentifié, l'authentification est valide pour toutes les ressources contenues dans un domaine donné. Pour obtenir une description détaillée des domaines, consultez RFC 2617 à l’adresse https://www.ietf.org/.

Une instance de n’a HttpListener qu’un seul domaine associé.