AuthenticationManager.PreAuthenticate メソッド

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

AuthenticationManager.PreAuthenticate メソッド

要求の事前認証を行います。

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

Visual Basic (宣言)

Public Shared Function PreAuthenticate
 ( _
    request As WebRequest, _
    credentials As ICredentials _
) As Authorization

Visual Basic (使用法)

Dim request As WebRequest
Dim credentials As ICredentials
Dim returnValue As Authorization

returnValue = AuthenticationManager.PreAuthenticate(request, credentials)

C#

public static Authorization PreAuthenticate
 (
    WebRequest request,
    ICredentials credentials
)

C++

public:
static Authorization^ PreAuthenticate (
    WebRequest^ request, 
    ICredentials^ credentials
)

J#

public static Authorization PreAuthenticate
 (
    WebRequest request, 
    ICredentials credentials
)

JScript

public static function PreAuthenticate
 (
    request : WebRequest, 
    credentials : ICredentials
) : Authorization

パラメータ

request

インターネット リソースへの WebRequest。

credentials

要求と関連付けられた ICredentials。

戻り値
要求を事前認証できる場合は Authorization クラスのインスタンス。それ以外の場合は null 参照 (Visual Basic では Nothing)。credentials が null 参照 (Visual Basic では Nothing) の場合、このメソッドは null 参照 (Visual Basic では Nothing) を返します。

例外

例外の種類	条件
ArgumentNullException	request が null 参照 (Visual Basic では Nothing) です。

解説

認証モジュールが要求を事前認証できる場合、PreAuthenticate メソッドは Authentication インスタンスを返し、リソースがチャレンジを発行するまで待機せずに、サーバーに対してプリエンプティブに承認情報を送信します。この動作については、RFC 2617 (HTTP Authentication: Basic and Digest Access Authentication) のセクション 3.3 に概要が示されています。事前認証をサポートする認証モジュールによって、クライアントは認証チャレンジから生じる余分なラウンド トリップを回避して、サーバーの効率を向上させることができます。

要求を事前認証できる承認モジュールは、IAuthenticationModule.CanPreAuthenticate プロパティを true に設定します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
AuthenticationManager クラス
AuthenticationManager メンバ
System.Net 名前空間