IntranetZoneCredentialPolicy クラスとは何？わかりやすく解説 Weblio辞書

.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

public class IntranetZoneCredentialPolicy :
 ICredentialPolicy

C++

public ref class IntranetZoneCredentialPolicy
 : ICredentialPolicy

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

 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) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。