HttpListener.Realm 屬性

定義

命名空間:

System.Net

組件:

System.Net.HttpListener.dll

來源:

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 實例只有一個相關聯的領域。