HttpListener.Realm Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.HttpListener.dll

Origem:

HttpListener.cs

Obtém ou define o realm, ou partição de recurso, associado a esse objeto 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

Valor da propriedade

String

Um valor String que contém o nome do realm associado ao objeto HttpListener.

Exceções

ObjectDisposedException

Este objeto foi fechado.

Exemplos

O exemplo de código a seguir demonstra a configuração da Realm propriedade.

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

Comentários

Os servidores usam realms para particionar recursos protegidos; cada partição pode ter seu próprio esquema de autenticação e/ou banco de dados de autorização. Os realms são usados apenas para autenticação básica e de hash. Depois que um cliente é autenticado com êxito, a autenticação é válida para todos os recursos em um determinado realm. Para obter uma descrição detalhada dos realms, consulte RFC 2617 em https://www.ietf.org/.

Uma instância de HttpListener tem apenas um realm associado.