Principal クラス

定義

すべてのセキュリティ プリンシパルに共通のアカウント データと操作をカプセル化します。Encapsulates the account data and operations common to all security principals. これは、すべてのセキュリティ プリンシパルの派生元となる抽象基本クラスです。This is the abstract base class from which all security principals are derived.

public ref class Principal abstract : IDisposable
public abstract class Principal : IDisposable
type Principal = class
    interface IDisposable
Public MustInherit Class Principal
Implements IDisposable
継承
Principal
派生
実装

注釈

このクラスから派生するカスタム拡張クラスは、派生クラスのコンストラクターからこのコンストラクターを呼び出して、基底クラスを初期化できます。Custom extension classes that derive from this class can call this constructor from the derived class constructor to initialize the base class. 詳細については、「プリンシパル拡張機能の概要」を参照してください。For more information, see the Principal Extensions overview topic.

コンストラクター

Principal()

Principal クラスの新しいインスタンスを初期化します。Initializes a new instance of the Principal class. このコンストラクターは、派生クラスのコンストラクターによって呼び出されて基本クラスを初期化するもので、独自に作成したコードから直接呼び出すためのものではありません。This constructor is called by derived-class constructors to initialize the base class and is not intended to be called directly from your code.

プロパティ

Context

プリンシパルと関連付けられているプリンシパル コンテキストを取得します。Gets a principal context that is associated with the principal.

ContextRaw

このプリンシパルと関連付けられているプリンシパル コンテキストを取得します。Gets a principal context that is associated with this principal.

ContextType

このプリンシパルに関連付けられているプリンシパル コンテキストのタイプを指定するコンテキスト タイプの列挙値を取得します。Gets the context type enumeration value that specifies the type of principal context associated with this principal.

Description

プリンシパルの説明を取得または設定します。Gets or sets the description of the principal.

DisplayName

このプリンシパルの表示名を取得または設定します。Gets or sets the display name for this principal.

DistinguishedName

このプリンシパルの識別名 (DN) を取得します。Gets the distinguished name (DN) for this principal.

Guid

このプリンシパルに関連付けられている GUID を取得します。Gets the GUID associated with this principal.

Name

このプリンシパルの名前を取得または設定します。Gets or sets the name of this principal.

SamAccountName

このプリンシパルの SAM アカウント名を取得または設定します。Gets or sets the SAM account name for this principal.

Sid

プリンシパルのセキュリティ ID (SID) を取得します。Gets the Security ID (SID) of the principal.

StructuralObjectClass

構造型オブジェクト クラス ディレクトリ属性を取得します。Gets the structural object class directory attribute.

UserPrincipalName

このプリンシパルに関連付けられているユーザー プリンシパル名 (UPN) を取得または設定します。Gets or sets the user principal name (UPN) associated with this principal.

メソッド

CheckDisposedOrDeleted()

Dispose() メソッドまたは Delete() メソッドがこのクラスで呼び出されているかどうかを確認します。Determines whether the Dispose() or Delete() methods have been called on this class. このメソッドは、このプリンシパル クラスから派生したクラスによって呼び出されます。This method is called by classes that derive from this principal class.

Delete()

ストアからプリンシパル オブジェクトを削除します。Deletes the principal object from the store.

Dispose()

現在の Principal オブジェクトのインスタンスを破棄します。Disposes the current instance of the Principal object.

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを示すブール値を返します。Returns a Boolean value that specifies whether the supplied object is equal to the current object.

ExtensionGet(String)

拡張されたクラス オブジェクトの属性を取得します。Retrieves an attribute of an extended class object.

ExtensionSet(String, Object)

拡張クラスの属性値を設定します。Sets the value of an attribute in an extended class.

FindByIdentity(PrincipalContext, IdentityType, String)

指定された ID の種類および値と一致するプリンシパル オブジェクトを返します。Returns a principal object that matches the specified identity type, and value. このバージョンの FindByIdentity(PrincipalContext, IdentityType, String) メソッドでは、ID 値の形式が指定されます。This version of the FindByIdentity(PrincipalContext, IdentityType, String) method determines the format of the identity value.

FindByIdentity(PrincipalContext, String)

指定された ID 値と一致するプリンシパル オブジェクトを返します。Returns a principal object that matches the specified identity value.

FindByIdentityWithType(PrincipalContext, Type, IdentityType, String)

指定された ID の種類および値と一致するプリンシパル オブジェクトを返します。Returns a principal object that matches the specified identity type, and value. このメソッドは、派生クラスの FindByIdentity メソッドの実装により呼び出され、検索対象を派生クラスに限定します。独自に作成したコードから直接呼び出すためのものではありません。This method is called by the implementation of the derived-class FindByIdentity method to restrict the search to the derived class type and is not intended to be called directly from your code.

FindByIdentityWithType(PrincipalContext, Type, String)

指定された ID の種類および値と一致するプリンシパル オブジェクトを返します。Returns a principal object that matches the specified identity type, and value. このメソッドは、派生クラスの FindByIdentity メソッドの実装により呼び出され、検索対象を派生クラスに限定します。独自に作成したコードから直接呼び出すためのものではありません。This method is called by the implementation of the derived-class FindByIdentity method to restrict the search to the derived class type and is not intended to be called directly from your code.

GetGroups()

現在のプリンシパルがメンバーであるグループを指定するグループ オブジェクトのコレクションを返します。Returns a collection of group objects that specify the groups of which the current principal is a member.

GetGroups(PrincipalContext)

プリンシパルがメンバーであるグループ オブジェクト、および指定されたコンテキスト パラメーターによって示されるストアに存在するグループ オブジェクトのコレクションを返します。Returns a collection of group objects that the principal is a member of and that exist in the store provided by the specified context parameter.

GetHashCode()

プリンシパル オブジェクトのコンテンツから作成されたハッシュを取得します。ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。Retrieves the hash created from the contents of the principal object, suited for use in hashing algorithms and data structures like a hash table.

GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
GetUnderlyingObject()

プリンシパル オブジェクトの連絡先データを提供する、基になる DirectoryEntry オブジェクトを返します。Returns the underlying DirectoryEntry object that provides the contact data for the principal object.

GetUnderlyingObjectType()

基になるオブジェクト型を返します。Returns the underlying object type.

IsMemberOf(GroupPrincipal)

プリンシパルが、指定されたグループのメンバーであるかどうかを示すブール値を返します。Returns a Boolean value that specifies whether the principal is a member of the specified group.

IsMemberOf(PrincipalContext, IdentityType, String)

プリンシパルが、ID の型と値で指定されたグループのメンバーであるかどうかを示すブール値を返します。Returns a Boolean value that specifies whether the principal is a member of the group specified by identity type and value.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
Save()

プリンシパル オブジェクトに対する変更をストアに保存します。Saves the changes that were made on the principal object to the store. これが新しいプリンシパル オブジェクトである場合は、このオブジェクトがストアに挿入されます。If this is a new principal object, this method inserts it into the store.

Save(PrincipalContext)

プリンシパル オブジェクトに対する変更をストアに保存します。Saves the changes that were made on the principal object to the store. これが新しいプリンシパル オブジェクトである場合は、このオブジェクトが、指定されたコンテキストに挿入されます。If this is a new principal object, this method inserts it into the specified context. プリンシパルが既に存在している場合は、元のコンテキストから、指定されたコンテキストにプリンシパルが移動します。If the principal has already been persisted, it is moved from the original context to the specified context.

ToString()

現在のプリンシパル オブジェクトのユーザー フレンドリ文字列表現を返します。Returns a user friendly string representation of the current principal object.

適用対象