DirectoryContext

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

DirectoryContext クラス

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

DirectoryContext クラスは、特定のディレクトリおよびディレクトリへのアクセスに使用される資格情報を識別します。

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

Visual Basic (宣言)

Public Class DirectoryContext

Visual Basic (使用法)

Dim instance As DirectoryContext

C#

public class DirectoryContext

C++

public ref class DirectoryContext

J#

public class DirectoryContext

JScript

public class DirectoryContext

解説

ディレクトリ コンテキストは、ドメインやフォレストなどの System.DirectoryServices.ActiveDirectory ディレクトリ オブジェクトのメソッドやプロパティにアクセスする前に作成する必要があります。

ディレクトリ コンテキストを作成するときは、該当するコンストラクタを使用して、プロセスの現在の資格情報や別の資格情報をそのコンテキストに適用できます。これらの資格情報により、プログラムがディレクトリ オブジェクトにアクセスする際のアクセス許可が決定されます。Active Directory オブジェクトは、管理者権限を持たないユーザーによる検索や変更から保護されている可能性があるため、プログラムを正常に動作させるには、対象オブジェクトに対するアクセス許可を持つ別の資格情報の使用が必要になることがあります。

許可される対象の種類と対象文字列の形式の説明の一覧を次の表に示します。

アクセス先の種類	DirectoryContextType のメンバ	アクセス先の名前の形式
ドメイン コントローラ	DirectoryServer	ドメイン コントローラの DNS 名
ADAM インスタンス	DirectoryServer	ADAM サーバーの DNS 名と LDAP ポート番号 (たとえば、adam_instance.fabrikam.com:389)
ドメイン	Domain	ドメインの DNS 名 (たとえば、sales.corp.fabrikam.com)
フォレスト	Forest	フォレストの DNS 名 (たとえば、corp.fabrikam.com)
アプリケーション パーティション	ApplicationPartition	アプリケーション パーティションの DNS 名
ADAM 構成セット	ConfigurationSet	構成セットの ADAM インスタンスによって登録されるサービス コネクション ポイントに関連付けられたキーワードの 1 つ。

継承階層

System.Object
  System.DirectoryServices.ActiveDirectory.DirectoryContext

スレッド セーフ

この型の 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

参照

関連項目
DirectoryContext メンバ
System.DirectoryServices.ActiveDirectory 名前空間

DirectoryContext コンストラクタ (DirectoryContextType)

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

現在のユーザー コンテキストの資格情報が格納された、指定された種類の DirectoryContext クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    contextType As DirectoryContextType _
)

Visual Basic (使用法)

Dim contextType As DirectoryContextType

Dim instance As New DirectoryContext(contextType)

C#

public DirectoryContext (
    DirectoryContextType contextType
)

C++

public:
DirectoryContext (
    DirectoryContextType contextType
)

J#

public DirectoryContext (
    DirectoryContextType contextType
)

JScript

public function DirectoryContext (
    contextType : DirectoryContextType
)

パラメータ

contextType

作成するコンテキストの種類を指定する、DirectoryContextType のいずれかのメンバ。このコンストラクタの場合、コンテキストの種類は Domain か Forest にする必要があります。他の種類のディレクトリ コンテキストは、このコンストラクタを使用して作成できません。他の種類では、ディレクトリまたはターゲット名を指定するパラメータを含んだコンストラクタが必要です。

例外

例外の種類	条件
ArgumentException	contextType が有効ではありません。
PlatformNotSupportedException	このクラスは、現在のプラットフォームでは動作しません。

.NET Framework のセキュリティ

• DirectoryServicesPermission  要求値 : Demand

プラットフォーム

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

参照

関連項目
DirectoryContext クラス
DirectoryContext メンバ
System.DirectoryServices.ActiveDirectory 名前空間
DirectoryContextType

DirectoryContext コンストラクタ (DirectoryContextType, String)

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

指定された名前と現在のユーザー コンテキストの資格情報が格納された、指定された種類の DirectoryContext クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    contextType As DirectoryContextType, _
    name As String _
)

Visual Basic (使用法)

Dim contextType As DirectoryContextType
Dim name As String

Dim instance As New DirectoryContext(contextType,
 name)

C#

public DirectoryContext (
    DirectoryContextType contextType,
    string name
)

C++

public:
DirectoryContext (
    DirectoryContextType contextType, 
    String^ name
)

J#

public DirectoryContext (
    DirectoryContextType contextType, 
    String name
)

JScript

public function DirectoryContext (
    contextType : DirectoryContextType, 
    name : String
)

パラメータ

contextType

作成するコンテキストの種類を指定する、DirectoryContextType のいずれかのメンバ。

name

ディレクトリ コンテキストの対象。この文字列は、DirectoryContext のトピックの「解説」で定義されるいずれかの形式を取ることができます。

例外

例外の種類	条件
ArgumentException	name が有効ではありません。
ArgumentNullException	name が null 参照 (Visual Basic では Nothing) です。
InvalidEnumArgumentException	contextType が有効ではありません。
PlatformNotSupportedException	このクラスは、現在のプラットフォームでは動作しません。

.NET Framework のセキュリティ

• DirectoryServicesPermission  要求値 : Demand

プラットフォーム

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

参照

関連項目
DirectoryContext クラス
DirectoryContext メンバ
System.DirectoryServices.ActiveDirectory 名前空間
DirectoryContextType

DirectoryContext コンストラクタ (DirectoryContextType, String, String)

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

指定したユーザー名とパスワードが格納された、指定した種類の DirectoryContext クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    contextType As DirectoryContextType, _
    username As String, _
    password As String _
)

Visual Basic (使用法)

Dim contextType As DirectoryContextType
Dim username As String
Dim password As String

Dim instance As New DirectoryContext(contextType,
 username, password)

C#

public DirectoryContext (
    DirectoryContextType contextType,
    string username,
    string password
)

C++

public:
DirectoryContext (
    DirectoryContextType contextType, 
    String^ username, 
    String^ password
)

J#

public DirectoryContext (
    DirectoryContextType contextType, 
    String username, 
    String password
)

JScript

public function DirectoryContext (
    contextType : DirectoryContextType, 
    username : String, 
    password : String
)

パラメータ

contextType

作成するコンテキストの種類を指定する、DirectoryContextType のいずれかのメンバ。このコンストラクタの場合、このパラメータは System.DirectoryServices.ActiveDirectory.DirectoryContextType か System.DirectoryServices.ActiveDirectory.DirectoryContextType にする必要があります。

username

アクセスに使用するユーザー名。

password

アクセスに使用するパスワード。

例外

例外の種類	条件
ArgumentException	contextType が有効ではありません。
PlatformNotSupportedException	このクラスは、現在のプラットフォームでは動作しません。

.NET Framework のセキュリティ

• DirectoryServicesPermission  要求値 : Demand

プラットフォーム

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

参照

関連項目
DirectoryContext クラス
DirectoryContext メンバ
System.DirectoryServices.ActiveDirectory 名前空間
DirectoryContextType

DirectoryContext コンストラクタ (DirectoryContextType, String, String, String)

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

指定した対象、ユーザー名、およびパスワードが格納された、指定した種類の DirectoryContext クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    contextType As DirectoryContextType, _
    name As String, _
    username As String, _
    password As String _
)

Visual Basic (使用法)

Dim contextType As DirectoryContextType
Dim name As String
Dim username As String
Dim password As String

Dim instance As New DirectoryContext(contextType,
 name, username, password)

C#

public DirectoryContext (
    DirectoryContextType contextType,
    string name,
    string username,
    string password
)

C++

public:
DirectoryContext (
    DirectoryContextType contextType, 
    String^ name, 
    String^ username, 
    String^ password
)

J#

public DirectoryContext (
    DirectoryContextType contextType, 
    String name, 
    String username, 
    String password
)

JScript

public function DirectoryContext (
    contextType : DirectoryContextType, 
    name : String, 
    username : String, 
    password : String
)

パラメータ

contextType

作成するコンテキストの種類を指定する、DirectoryContextType のいずれかのメンバ。

name

ディレクトリ コンテキストのターゲット。この文字列は、DirectoryContext のトピックの「解説」で定義されるいずれかの形式を取ることができます。

username

アクセスに使用するユーザー名。

password

アクセスに使用するパスワード。

例外

例外の種類	条件
ArgumentException	name が有効ではありません。
ArgumentNullException	name が null 参照 (Visual Basic では Nothing) です。
InvalidEnumArgumentException	contextType が有効ではありません。
PlatformNotSupportedException	このクラスは、現在のプラットフォームでは動作しません。

.NET Framework のセキュリティ

• DirectoryServicesPermission  要求値 : Demand

プラットフォーム

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

参照

関連項目
DirectoryContext クラス
DirectoryContext メンバ
System.DirectoryServices.ActiveDirectory 名前空間
DirectoryContextType

DirectoryContext コンストラクタ

DirectoryContext クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
DirectoryContext (DirectoryContextType)	現在のユーザー コンテキストの資格情報が格納された、指定された種類の DirectoryContext クラスの新しいインスタンスを初期化します。
DirectoryContext (DirectoryContextType, String)	指定された名前と現在のユーザー コンテキストの資格情報が格納された、指定された種類の DirectoryContext クラスの新しいインスタンスを初期化します。
DirectoryContext (DirectoryContextType, String, String)	指定したユーザー名とパスワードが格納された、指定した種類の DirectoryContext クラスの新しいインスタンスを初期化します。
DirectoryContext (DirectoryContextType, String, String, String)	指定した対象、ユーザー名、およびパスワードが格納された、指定した種類の DirectoryContext クラスの新しいインスタンスを初期化します。

参照

関連項目

DirectoryContext クラス
DirectoryContext メンバ
System.DirectoryServices.ActiveDirectory 名前空間
DirectoryContextType

DirectoryContext プロパティ

パブリック プロパティ

	名前	説明
	ContextType	コンテキスト オブジェクトの種類を取得します。
	Name	コンテキストの名前を取得します。
	UserName	コンテキストのユーザー名を取得します。

参照

関連項目

DirectoryContext クラス
System.DirectoryServices.ActiveDirectory 名前空間

DirectoryContext メソッド

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

DirectoryContext クラス
System.DirectoryServices.ActiveDirectory 名前空間

DirectoryContext メンバ

DirectoryContext クラスは、特定のディレクトリおよびディレクトリへのアクセスに使用される資格情報を識別します。

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

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

	名前	説明
	DirectoryContext	オーバーロードされます。 DirectoryContext クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	ContextType	コンテキスト オブジェクトの種類を取得します。
	Name	コンテキストの名前を取得します。
	UserName	コンテキストのユーザー名を取得します。

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

DirectoryContext クラス
System.DirectoryServices.ActiveDirectory 名前空間