AuthenticationSchemeSelector デリゲートとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

AuthenticationSchemeSelector デリゲート

メモ : このデリゲートは、.NET Framework version 2.0 で新しく追加されたものです。

HttpListener インスタンスの認証方式を選択します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Delegate Function
 AuthenticationSchemeSelector ( _
    httpRequest As HttpListenerRequest _
) As AuthenticationSchemes

Visual Basic (使用法)

Dim instance As New AuthenticationSchemeSelector(AddressOf
 HandlerMethod)

public delegate AuthenticationSchemes AuthenticationSchemeSelector
 (
    HttpListenerRequest httpRequest
)

C++

public delegate AuthenticationSchemes AuthenticationSchemeSelector
 (
    HttpListenerRequest^ httpRequest
)

/** @delegate */
public delegate AuthenticationSchemes AuthenticationSchemeSelector
 (
    HttpListenerRequest httpRequest
)

JScript

JScript では、デリゲートは使用できますが、新規に宣言することはできません。

パラメータ

httpRequest: 認証方式の選択対象となる HttpListenerRequest インスタンス。

戻り値
指定したクライアント要求に使用する認証のメソッドを示す AuthenticationSchemes 値の 1 つ。

解説

この種類のデリゲートは、要求の特性に基づいて認証方式を選択するために HttpListener インスタンスによって使用されます。

AuthenticationSchemeSelector デリゲートは、認証情報を提供していない各受信要求の HttpListenerRequest オブジェクトに渡されます。このデリゲートによって呼び出されたメソッドは、HttpListenerRequest オブジェクトおよび他の入手可能な情報を使用して、必要な認証方式を決定します。このデリゲートは、AuthenticationSchemeSelectorDelegate プロパティを使用して指定されます。

使用例

この種類のインスタンスを使用して AuthenticationSchemeSelectorDelegate プロパティを設定する例を次に示します。

// Set up a listener.
HttpListener listener = new HttpListener();
HttpListenerPrefixCollection prefixes = listener.Prefixes;
prefixes.Add(@"http://localhost:8080/");
prefixes.Add(@"http://contoso.com:8080/");

// Specify the authentication delegate.
listener.AuthenticationSchemeSelectorDelegate = 
    new AuthenticationSchemeSelector (AuthenticationSchemeForClient);

// Start listening for requests and process them 
// synchronously.
listener.Start();

前の例で AuthenticationSchemeSelector デリゲートによって呼び出されているメソッドの実装例を次に示します。

static AuthenticationSchemes AuthenticationSchemeForClient(HttpListenerRequest
 request)
{
    Console.WriteLine("Client authentication protocol selection in
 progress...");
    // Do not authenticate local machine requests.
    if (request.RemoteEndPoint.Address.Equals (IPAddress.Loopback))
    {
        return AuthenticationSchemes.None;
    }
    else
    {
        return AuthenticationSchemes.IntegratedWindowsAuthentication;
    }
}