WebClientProtocol.PreAuthenticate プロパティ

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

WebClientProtocol.PreAuthenticate プロパティ

事前認証を有効にするかどうかを取得または設定します。

名前空間: System.Web.Services.Protocols
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public Property PreAuthenticate As
 Boolean

Visual Basic (使用法)

Dim instance As WebClientProtocol
Dim value As Boolean

value = instance.PreAuthenticate

instance.PreAuthenticate = value

C#

public bool PreAuthenticate { get;
 set; }

C++

public:
property bool PreAuthenticate {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_PreAuthenticate ()

/** @property */
public void set_PreAuthenticate (boolean value)

JScript

public function get PreAuthenticate
 () : boolean

public function set PreAuthenticate
 (value : boolean)

プロパティ値
要求を事前に認証する場合は true。それ以外の場合は false。既定値は false です。

解説

クライアントが資格情報を使用せずにリソースを要求した場合、サーバーはその要求を受け付けず、サポートされている認証方法を示します。クライアントは認証方法を選択し、適切な WWW-authenticate ヘッダーをサーバーに送信します。PreAuthenticate が true の場合、WWW-authenticate ヘッダーは後続のすべての要求と共に送信されます。

PreAuthenticate が false の場合は、最初にユーザーを認証することなく、XML Web サービス メソッドが要求されます。XML Web サービスで匿名アクセスが許可されている場合は、XML Web サービス メソッドが実行されます。匿名アクセスが許可されていない場合は、401 HTTP リターン コードがクライアントへ返信されます。これに応答して、WebClientProtocol クラスは、Web サーバーに認証資格情報を返します。クライアントが認証され、続けて XML Web サービスへのアクセスが許可された場合は、その XML Web サービス メソッドが実行されます。それ以外の場合は、クライアントによるアクセスは拒否されます。

プラットフォーム

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

参照

関連項目
WebClientProtocol クラス
WebClientProtocol メンバ
System.Web.Services.Protocols 名前空間
PreAuthenticate