IntranetZoneCredentialPolicy

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

IntranetZoneCredentialPolicy クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

WebRequest およびその派生クラスを使用して行われるリソース要求に使用する資格情報ポリシーを定義します。

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

Visual Basic (宣言)

Public Class IntranetZoneCredentialPolicy
    Implements ICredentialPolicy

Visual Basic (使用法)

Dim instance As IntranetZoneCredentialPolicy

C#

public class IntranetZoneCredentialPolicy :
 ICredentialPolicy

C++

public ref class IntranetZoneCredentialPolicy
 : ICredentialPolicy

J#

public class IntranetZoneCredentialPolicy implements
 ICredentialPolicy

JScript

public class IntranetZoneCredentialPolicy implements
 ICredentialPolicy

解説

このポリシーを使用すると、要求されたリソースが、要求を行っているクライアントと同じドメインにある場合にのみ、資格情報が送付されます。多くのアプリケーションでは、これが最適なポリシーです。その理由は、イントラネットにないリソースの要求と共にネットワーク資格情報が送付されるのを防げるからです。

メモ
ICredentialPolicy ポリシーは、要求に関連付けられている WebRequest または WebProxy の資格情報が null 参照 (Visual Basic では Nothing) でない場合にのみ呼び出されます。このポリシーの設定は、資格情報が指定されていない要求には影響を与えません。

AuthenticationManager.CredentialPolicy プロパティを使用して、IntranetZoneCredentialPolicy ポリシーを設定します。要求の認証を実行する前に、認証を処理する IAuthenticationModule によって ShouldSendCredential メソッドが呼び出されます。要求されたリソースがクライアントと異なるドメインに存在する場合、ShouldSendCredential メソッドは false を返し、認証は実行されません。

このポリシーは、現在のアプリケーション ドメインに存在する、null 以外の資格情報を持つ WebRequest のすべてのインスタンスに影響を与えます。このポリシーは、個別の要求でオーバーライドできません。

使用例

IntranetZoneCredentialPolicy のインスタンスを生成し、これを使用してアプリケーション ドメインの資格情報ポリシーを設定するコード例を次に示します。

C#

 public static void UseIntranetCredentialPolicy()
{
    IntranetZoneCredentialPolicy  policy = new IntranetZoneCredentialPolicy();
    AuthenticationManager.CredentialPolicy = policy;
}

C++

static void UseIntranetCredentialPolicy()
{
   IntranetZoneCredentialPolicy^ policy = gcnew IntranetZoneCredentialPolicy;
   AuthenticationManager::CredentialPolicy = policy;
}

継承階層

System.Object
  Microsoft.Win32.IntranetZoneCredentialPolicy

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
IntranetZoneCredentialPolicy メンバ
Microsoft.Win32 名前空間

IntranetZoneCredentialPolicy コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

IntranetZoneCredentialPolicy クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New IntranetZoneCredentialPolicy

C#

public IntranetZoneCredentialPolicy ()

C++

public:
IntranetZoneCredentialPolicy ()

J#

public IntranetZoneCredentialPolicy ()

JScript

public function IntranetZoneCredentialPolicy
 ()

解説

アプリケーションでは、このコンストラクタを使用して、CredentialPolicy プロパティの設定に使用するオブジェクトを作成します。

使用例

このクラスのインスタンスを生成するコード例を次に示します。

C#

 public static void UseIntranetCredentialPolicy()
{
    IntranetZoneCredentialPolicy  policy = new IntranetZoneCredentialPolicy();
    AuthenticationManager.CredentialPolicy = policy;
}

C++

static void UseIntranetCredentialPolicy()
{
   IntranetZoneCredentialPolicy^ policy = gcnew IntranetZoneCredentialPolicy;
   AuthenticationManager::CredentialPolicy = policy;
}

プラットフォーム

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

参照

関連項目
IntranetZoneCredentialPolicy クラス
IntranetZoneCredentialPolicy メンバ
Microsoft.Win32 名前空間

IntranetZoneCredentialPolicy メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ShouldSendCredential	クライアントの資格情報が、WebRequest を使用して行われたリソース要求と共に送信されたかどうかを示す Boolean を返します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

IntranetZoneCredentialPolicy クラス
Microsoft.Win32 名前空間

IntranetZoneCredentialPolicy メンバ

WebRequest およびその派生クラスを使用して行われるリソース要求に使用する資格情報ポリシーを定義します。

IntranetZoneCredentialPolicy データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	IntranetZoneCredentialPolicy	IntranetZoneCredentialPolicy クラスの新しいインスタンスを初期化します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ShouldSendCredential	クライアントの資格情報が、WebRequest を使用して行われたリソース要求と共に送信されたかどうかを示す Boolean を返します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

IntranetZoneCredentialPolicy クラス
Microsoft.Win32 名前空間