PrincipalContext Oluşturucular

Tanım

Ad Alanı:

System.DirectoryServices.AccountManagement

Bütünleştirilmiş Kod:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

PrincipalContext sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

PrincipalContext(ContextType)	Belirtilen bağlam türüyle sınıfının yeni bir örneğini PrincipalContext başlatır.
PrincipalContext(ContextType, String)	Belirtilen bağlam türü ve adıyla sınıfının yeni bir örneğini PrincipalContext başlatır.
PrincipalContext(ContextType, String, String)	Belirtilen bağlam türü, adı ve kapsayıcı ile sınıfının yeni bir örneğini PrincipalContext başlatır.
PrincipalContext(ContextType, String, String, ContextOptions)	Belirtilen bağlam türü, ad, kapsayıcı ve bağlam seçenekleriyle sınıfının yeni bir örneğini PrincipalContext başlatır.
PrincipalContext(ContextType, String, String, String)	Belirtilen bağlam türü, ad, kullanıcı adı ve parola ile sınıfının yeni bir örneğini PrincipalContext başlatır.
PrincipalContext(ContextType, String, String, String, String)	Belirtilen bağlam türü, ad, kapsayıcı, kullanıcı adı ve parola ile sınıfının yeni bir örneğini PrincipalContext başlatır.
PrincipalContext(ContextType, String, String, ContextOptions, String, String)	Belirtilen bağlam türü, ad, kapsayıcı, bağlam seçenekleri, kullanıcı adı ve parola ile sınıfının yeni bir örneğini PrincipalContext başlatır.

Açıklamalar

Oluşturucular PrincipalContext parametrelerin ve sunucunun doğrulamasını gerçekleştirir, ancak kimlik bilgilerini doğrulamayı denemez.

Asıl bağlam nesnesi bir kapsayıcı belirtilmeden oluşturulduğunda, birden çok ayrı kapsayıcıyı temsil etmek için kullanılabilir. Sorgu işlemlerinin temeli olarak bir kapsayıcı kullanılabilirken, ek kapsayıcılar yeni oluşturulan asıl nesneleri barındırabilir. Örneğin, kullanıcılar veya gruplar etki alanı bağlam türüne eklendiğinde Hesap Yönetimi API'si varsayılan iyi bilinen "CN=Users,DC=Fabrikam,DC=com" kullanıcı kapsayıcısını kullanır. Bilgisayarlar depoya eklendiğinde API varsayılan "CN=Computers,DC=Fabrikam,DC=com" kapsayıcısını kullanır. Varsayılan kapsayıcı adlarının etki alanı yöneticisi tarafından değiştirilebileceğini unutmayın. Asıl nesne oluşturucuları yalnızca bir asıl bağlam belirtebildiğinden, uygulama bir kapsayıcı belirtmeden bir etki alanı bağlamı oluşturduğunda ek bağlamlar varsayılan davranış olarak gösterilir. Uygulama dizininde iyi bilinen kapsayıcılar olmadığından, uygulamanın oluşturucuda bir kapsayıcı belirtmesi gerekir veya ArgumentException oluşturulur. SAM'nin kapsayıcıları olmadığından, ArgumentException uygulama oluşturucuda bir kapsayıcı belirtmeye çalışırsa oluşturulur.

Bir kullanıcı adını parametre olarak alan oluşturucunun her sürümünde, userName dize çeşitli biçimlerde olabilir. için desteklenen üç NameFormats: Nt4Name, UserPrincipalName ve SamAccountName. Ad biçimleri hakkında daha fazla bilgi için ADS_NAME_TYPE_ENUM belgelerine bakın.

PrincipalContext(ContextType)

Kaynak:

Context.cs

Belirtilen bağlam türüyle sınıfının yeni bir örneğini PrincipalContext başlatır.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType)

Parametreler

contextType

ContextType

ContextType Asıl bağlam için depo türünü belirten bir numaralandırma değeri.

Özel durumlar

ArgumentException

Uygulama dizini bağlamı kullanılırken bir ad veya kapsayıcı belirtilmelidir.

InvalidEnumArgumentException

contextType parametresi geçerli ContextType bir numaralandırma değeri içermiyor.

PrincipalContext(ContextType, String)

Kaynak:

Context.cs

Belirtilen bağlam türü ve adıyla sınıfının yeni bir örneğini PrincipalContext başlatır.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String)

Parametreler

contextType

ContextType

ContextType Asıl bağlam için depo türünü belirten bir numaralandırma değeri.

name

String

Bağlam türleri için Domain etki alanının veya sunucunun adı, bağlam türleri için Machine makine adı veya örneği barındıran sunucunun ve bağlantı noktasının ApplicationDirectory adı.

Ad bir Domain bağlam türü içinse null bu bağlam, iş parçacığının altında çalıştığı kullanıcı sorumlusunun etki alanı için bir etki alanı denetleyicisidir. Ad null bir Machine bağlam türü içinse, bu yerel makine adıdır. Bu parametre bağlam türleri için ApplicationDirectory olamaznull.

Özel durumlar

ArgumentException

parametresinde belirtildiğinde ApplicationDirectorycontextType bir ad belirtilmelidir.

InvalidEnumArgumentException

contextType parametresi geçerli ContextType bir numaralandırma değeri içermiyor.

PrincipalContext(ContextType, String, String)

Kaynak:

Context.cs

Belirtilen bağlam türü, adı ve kapsayıcı ile sınıfının yeni bir örneğini PrincipalContext başlatır.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String)

Parametreler

contextType

ContextType

ContextType Asıl bağlam için depo türünü belirten bir numaralandırma değeri.

name

String

Bağlam türleri için Domain etki alanının veya sunucunun adı, bağlam türleri için Machine makine adı veya örneği barındıran sunucunun ve bağlantı noktasının ApplicationDirectory adı.

Ad bir Domain bağlam türü içinse null bu bağlam, iş parçacığının altında çalıştığı kullanıcı sorumlusunun etki alanı için bir etki alanı denetleyicisidir. Ad null bir Machine bağlam türü içinse, bu yerel makine adıdır. Bu parametre bağlam türleri için ApplicationDirectory olamaznull.

container

String

Bağlamın kökü olarak kullanılacak depodaki kapsayıcı. Tüm sorgular bu kök altında gerçekleştirilir ve tüm eklemeler bu kapsayıcıya gerçekleştirilir.

ve ApplicationDirectory bağlam türleri için Domain bu parametre, kapsayıcı nesnesinin ayırt edici adıdır.

Bağlam türleri için Machine bu parametre olarak nullayarlanmalıdır.

Özel durumlar

ArgumentException

Bağlam türü parametresinde belirtildiğinde MachinecontextType kapsayıcı belirtilemez.

parametresinde contextType belirtildiğinde ApplicationDirectory bir ad veya kapsayıcı belirtilmelidir.

InvalidEnumArgumentException

contextType parametresi geçerli ContextType bir numaralandırma değeri içermiyor.

Açıklamalar

, InvalidOperationException asıl bağlam için belirtilen kapsayıcı geçerli bir Domain kapsayıcı değilse sunucuya bağlanan sonraki dizin işlemleri çağrılarında oluşturulabilir. Kapsayıcı, şema sınıfı, olasıInferiors özniteliğinde kullanıcı, grup veya bilgisayar gibi asıl sınıflara sahip olan bir nesne olarak tanımlanır.

PrincipalContext(ContextType, String, String, ContextOptions)

Kaynak:

Context.cs

Belirtilen bağlam türü, ad, kapsayıcı ve bağlam seçenekleriyle sınıfının yeni bir örneğini PrincipalContext başlatır.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::DirectoryServices::AccountManagement::ContextOptions options);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, System.DirectoryServices.AccountManagement.ContextOptions options);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * System.DirectoryServices.AccountManagement.ContextOptions -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions)

Parametreler

contextType

ContextType

ContextType Asıl bağlam için depo türünü belirten bir numaralandırma değeri.

name

String

Bağlam türleri için Domain etki alanının veya sunucunun adı, bağlam türleri için Machine makine adı veya örneği barındıran sunucunun ve bağlantı noktasının ApplicationDirectory adı.

Ad bir Domain bağlam türü içinse null bu bağlam, iş parçacığının altında çalıştığı kullanıcı sorumlusunun etki alanı için bir etki alanı denetleyicisidir. Ad null bir Machine bağlam türü içinse, bu yerel makine adıdır. Bu parametre bağlam türleri için ApplicationDirectory olamaznull.

container

String

Bağlamın kökü olarak kullanılacak depodaki kapsayıcı. Tüm sorgular bu kök altında gerçekleştirilir ve tüm eklemeler bu kapsayıcıya gerçekleştirilir.

ve ApplicationDirectory bağlam türleri için Domain bu parametre, kapsayıcı nesnesinin ayırt edici adıdır.

Bağlam türleri için Machine bu parametre olarak nullayarlanmalıdır.

options

ContextOptions

Sunucuya bağlanmak için kullanılan seçenekleri belirten bir veya daha fazla ContextOptions numaralandırma değerinin birleşimi. Bu parametre ise null, varsayılan seçenekler ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.

Özel durumlar

ArgumentException

Bağlam türü parametresinde belirtildiğinde MachinecontextType kapsayıcı belirtilemez.

parametresinde contextType belirtildiğinde ApplicationDirectory bir ad veya kapsayıcı belirtilmelidir.

InvalidEnumArgumentException

contextType parametresi geçerli ContextType bir numaralandırma değeri içermiyor.

options parametresi geçerli ContextOptions numaralandırma değerlerinin bir bileşimini içermez.

Açıklamalar

, InvalidOperationException asıl bağlam için belirtilen kapsayıcı geçerli bir Domain kapsayıcı değilse sunucuya bağlanan sonraki dizin işlemleri çağrılarında oluşturulabilir. Kapsayıcı, şema sınıfı, olasıInferiors özniteliğinde kullanıcı, grup veya bilgisayar gibi asıl sınıflara sahip olan bir nesne olarak tanımlanır.

PrincipalContext(ContextType, String, String, String)

Kaynak:

Context.cs

Belirtilen bağlam türü, ad, kullanıcı adı ve parola ile sınıfının yeni bir örneğini PrincipalContext başlatır.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ userName, System::String ^ password);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string userName, string password);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, userName As String, password As String)

Parametreler

contextType

ContextType

ContextType Asıl bağlam için depo türünü belirten bir numaralandırma değeri.

name

String

Bağlam türleri için Domain etki alanının veya sunucunun adı, bağlam türleri için Machine makine adı veya örneği barındıran sunucunun ve bağlantı noktasının ApplicationDirectory adı.

Ad bir Domain bağlam türü içinse null bu bağlam, iş parçacığının altında çalıştığı kullanıcı sorumlusunun etki alanı için bir etki alanı denetleyicisidir. Ad null bir Machine bağlam türü içinse, bu yerel makine adıdır. Bu parametre bağlam türleri için ApplicationDirectory olamaznull.

userName

String

Mağazaya bağlanmak için kullanılan kullanıcı adı. userName ve password parametreleri her ikisi de nullise, geçerli işlemin kimlik bilgileri kullanılır. Aksi takdirde, hem hem de userNamepassword null olmayan olmalıdır ve belirttikleri kimlik bilgileri depoya bağlanmak için kullanılır.

password

String

Mağazaya bağlanmak için kullanılan parola. userName ve password parametreleri her ikisi de nullise, geçerli işlemin kimlik bilgileri kullanılır. Aksi takdirde, hem hem de userNamepassword null olmayan olmalıdır ve belirttikleri kimlik bilgileri depoya bağlanmak için kullanılır.

Özel durumlar

ArgumentException

username ve password parametreleri bir değer içermelidir null veya içermelidir.

parametresinde belirtildiğinde ApplicationDirectorycontextType bir ad belirtilmelidir.

InvalidEnumArgumentException

contextType parametresi geçerli ContextType bir numaralandırma değeri içermiyor.

PrincipalContext(ContextType, String, String, String, String)

Kaynak:

Context.cs

Belirtilen bağlam türü, ad, kapsayıcı, kullanıcı adı ve parola ile sınıfının yeni bir örneğini PrincipalContext başlatır.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::String ^ userName, System::String ^ password);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, string userName, string password);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String, userName As String, password As String)

Parametreler

contextType

ContextType

ContextType Asıl bağlam için depo türünü belirten bir numaralandırma değeri.

name

String

Bağlam türleri için Domain etki alanının veya sunucunun adı, bağlam türleri için Machine makine adı veya örneği barındıran sunucunun ve bağlantı noktasının ApplicationDirectory adı.

Ad bir Domain bağlam türü içinse null bu bağlam, iş parçacığının altında çalıştığı kullanıcı sorumlusunun etki alanı için bir etki alanı denetleyicisidir. Ad null bir Machine bağlam türü içinse, bu yerel makine adıdır. Bu parametre bağlam türleri için ApplicationDirectory olamaznull.

container

String

Bağlamın kökü olarak kullanılacak depodaki kapsayıcı. Tüm sorgular bu kök altında gerçekleştirilir ve tüm eklemeler bu kapsayıcıya gerçekleştirilir.

ve ApplicationDirectory bağlam türleri için Domain bu parametre, kapsayıcı nesnesinin ayırt edici adıdır.

Bağlam türleri için Machine bu parametre olarak nullayarlanmalıdır.

userName

String

Mağazaya bağlanmak için kullanılan kullanıcı adı. userName ve password parametreleri her ikisi de nullise, geçerli sorumlunun varsayılan kimlik bilgileri kullanılır. Aksi takdirde, hem hem de userNamepassword null olmayan olmalıdır ve belirttikleri kimlik bilgileri depoya bağlanmak için kullanılır.

password

String

Mağazaya bağlanmak için kullanılan parola. userName ve password parametreleri her ikisi de nullise, geçerli sorumlunun varsayılan kimlik bilgileri kullanılır. Aksi takdirde, hem hem de userNamepassword null olmayan olmalıdır ve belirttikleri kimlik bilgileri depoya bağlanmak için kullanılır.

Özel durumlar

ArgumentException

username ve password parametreleri bir değer içermelidir null veya içermelidir.

Bağlam türü parametresinde belirtildiğinde MachinecontextType kapsayıcı belirtilemez.

name parametresinde belirtildiğinde ApplicationDirectorycontextType veya container belirtilmelidir.

InvalidEnumArgumentException

contextType parametresi geçerli ContextType bir numaralandırma değeri içermiyor.

Açıklamalar

, InvalidOperationException asıl bağlam için belirtilen kapsayıcı geçerli bir Domain kapsayıcı değilse sunucuya bağlanan sonraki dizin işlemleri çağrılarında oluşturulabilir. Kapsayıcı, şema sınıfı, olasıInferiors özniteliğinde kullanıcı, grup veya bilgisayar gibi asıl sınıflara sahip olan bir nesne olarak tanımlanır.

PrincipalContext(ContextType, String, String, ContextOptions, String, String)

Kaynak:

Context.cs

Belirtilen bağlam türü, ad, kapsayıcı, bağlam seçenekleri, kullanıcı adı ve parola ile sınıfın PrincipalContext yeni bir örneğini başlatır.

public:
 PrincipalContext(System::DirectoryServices::AccountManagement::ContextType contextType, System::String ^ name, System::String ^ container, System::DirectoryServices::AccountManagement::ContextOptions options, System::String ^ userName, System::String ^ password);

public PrincipalContext (System.DirectoryServices.AccountManagement.ContextType contextType, string name, string container, System.DirectoryServices.AccountManagement.ContextOptions options, string userName, string password);

new System.DirectoryServices.AccountManagement.PrincipalContext : System.DirectoryServices.AccountManagement.ContextType * string * string * System.DirectoryServices.AccountManagement.ContextOptions * string * string -> System.DirectoryServices.AccountManagement.PrincipalContext

Public Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions, userName As String, password As String)

Parametreler

contextType

ContextType

ContextType Asıl bağlam için depo türünü belirten bir numaralandırma değeri.

name

String

Bağlam türleri için Domain etki alanının veya sunucunun adı, bağlam türleri için Machine makine adı veya örneği barındıran sunucu ve bağlantı noktasının ApplicationDirectory adı.

Ad bir Domain bağlam türü içinse null bu bağlam, iş parçacığının altında çalıştığı kullanıcı sorumlusunun etki alanı için bir etki alanı denetleyicisidir. Ad null bir Machine bağlam türü içinse, bu yerel makine adıdır. Bu parametre bağlam türleri için ApplicationDirectory olamaznull.

container

String

Bağlamın kökü olarak kullanılacak depodaki kapsayıcı. Tüm sorgular bu kök altında gerçekleştirilir ve tüm eklemeler bu kapsayıcıya gerçekleştirilir.

ve ApplicationDirectory bağlam türleri için Domain bu parametre bir kapsayıcı nesnesinin ayırt edici adıdır.

Bağlam türleri için Machine bu parametre olarak nullayarlanmalıdır.

options

ContextOptions

Sunucuya bağlanmak için kullanılan seçeneklerin bir veya daha fazla ContextOptions sabit listesi değerinin birleşimi. Bu parametre ise null, varsayılan seçenekler ContextOptions.Negotiate | şeklindedir ContextOptions.Signing | ContextOptions.Sealing.

userName

String

Mağazaya bağlanmak için kullanılan kullanıcı adı. userName ve password parametreleri her ikisi de nullise, geçerli sorumlunun varsayılan kimlik bilgileri kullanılır. Aksi takdirde, hem hem password de userName null olmayan olmalıdır ve belirttikleri kimlik bilgileri depoya bağlanmak için kullanılır.

password

String

Mağazaya bağlanmak için kullanılan parola. userName ve password parametreleri her ikisi de nullise, geçerli sorumlunun varsayılan kimlik bilgileri kullanılır. Aksi takdirde, hem hem password de userName null olmayan olmalıdır ve belirttikleri kimlik bilgileri depoya bağlanmak için kullanılır.

Özel durumlar

ArgumentException

username ve password parametreleri bir değer içermelidir null veya içermelidir.

Bağlam türü parametresinde belirtildiğinde MachinecontextType kapsayıcı belirtilemez.

parametresinde belirtildiğinde ApplicationDirectorycontextType bir ad veya kapsayıcı belirtilmelidir.

InvalidEnumArgumentException

contextType parametresi geçerli ContextType bir numaralandırma değeri içermiyor.

options parametresi geçerli ContextOptions numaralandırma değerlerinin bir bileşimini içermiyor.

Açıklamalar

, InvalidOperationException asıl bağlam için belirtilen kapsayıcı geçerli bir Domain kapsayıcı değilse sunucuya bağlanan sonraki dizin işlemleri çağrılarında oluşturulabilir. Kapsayıcı, şema sınıfı, olasıInferiors özniteliğinde kullanıcı, grup veya bilgisayar gibi asıl sınıflara sahip olan bir nesne olarak tanımlanır.