AuthenticationSchemeSelector デリゲート

.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)

C#

public delegate AuthenticationSchemes AuthenticationSchemeSelector
 (
    HttpListenerRequest httpRequest
)

C++

public delegate AuthenticationSchemes AuthenticationSchemeSelector
 (
    HttpListenerRequest^ httpRequest
)

J#

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

JScript

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

パラメータ

httpRequest

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

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

解説

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

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

使用例

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

C#

// 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 デリゲートによって呼び出されているメソッドの実装例を次に示します。

C#

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;
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Net 名前空間