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

注釈

サーバーは領域を使用して保護されたリソースをパーティション分割します。各パーティションには、独自の認証スキームや承認データベースを含めることができます。 レルムは、基本認証およびダイジェスト認証だけに使用されます。 クライアントが正常に認証されると、その認証は特定のレルムのすべてのリソースに対して有効となります。 領域の詳細については、 の RFC 2617 https://www.ietf.org/を参照してください。

の HttpListener インスタンスには、関連付けられた領域が 1 つだけ含まれます。