HttpListener.Realm 属性

定义

命名空间:

System.Net

程序集:

System.Net.HttpListener.dll

Source:

HttpListener.cs

获取或设置与此 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

属性值

String

String 值，包含与 HttpListener 对象关联的领域名。

例外

ObjectDisposedException

此对象已关闭。

示例

下面的代码示例演示如何设置 Realm 属性。

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

注解

服务器使用领域对受保护的资源进行分区;每个分区可以有自己的身份验证方案和/或授权数据库。 领域仅用于基本和摘要式身份验证。 在客户端成功进行身份验证之后，该身份验证对给定领域内的所有资源都有效。 有关领域的详细说明，请参阅 中的 https://www.ietf.org/RFC 2617。

实例 HttpListener 只有一个关联的领域。