PrincipalContext Konstruktory

Definicja

Przestrzeń nazw:

System.DirectoryServices.AccountManagement

Zestaw:

System.DirectoryServices.AccountManagement.dll

Pakiet:

System.DirectoryServices.AccountManagement v8.0.0

Inicjuje nowe wystąpienie klasy PrincipalContext.

Przeciążenia

PrincipalContext(ContextType)	Inicjuje PrincipalContext nowe wystąpienie klasy o określonym typie kontekstu.
PrincipalContext(ContextType, String)	Inicjuje PrincipalContext nowe wystąpienie klasy o określonym typie kontekstu i nazwie.
PrincipalContext(ContextType, String, String)	Inicjuje PrincipalContext nowe wystąpienie klasy z określonym typem kontekstu, nazwą i kontenerem.
PrincipalContext(ContextType, String, String, ContextOptions)	Inicjuje PrincipalContext nowe wystąpienie klasy z określonym typem kontekstu, nazwą, kontenerem i opcjami kontekstu.
PrincipalContext(ContextType, String, String, String)	Inicjuje PrincipalContext nowe wystąpienie klasy z określonym typem kontekstu, nazwą, nazwą użytkownika i hasłem.
PrincipalContext(ContextType, String, String, String, String)	Inicjuje PrincipalContext nowe wystąpienie klasy z określonym typem kontekstu, nazwą, kontenerem, nazwą użytkownika i hasłem.
PrincipalContext(ContextType, String, String, ContextOptions, String, String)	Inicjuje PrincipalContext nowe wystąpienie klasy z określonym typem kontekstu, nazwą, kontenerem, opcjami kontekstu, nazwą użytkownika i hasłem.

Uwagi

PrincipalContext Konstruktory przeprowadzają walidację parametrów i serwera, ale nie próbują weryfikować poświadczeń.

Gdy główny obiekt kontekstu jest tworzony bez określania kontenera, może służyć do reprezentowania wielu odrębnych kontenerów. Jeden kontener może być używany jako baza operacji zapytań, podczas gdy dodatkowe kontenery mogą przechowywać nowo utworzone obiekty główne. Na przykład po wstawieniu użytkowników lub grup do typu kontekstu domeny interfejs API zarządzania kontami używa domyślnego dobrze znanego kontenera użytkownika "CN=Users,DC=Fabrikam,DC=com". Po wstawieniu komputerów do magazynu interfejs API używa domyślnego kontenera "CN=Computers,DC=Fabrikam,DC=com". Należy pamiętać, że domyślne nazwy kontenerów można zmienić przez administratora domeny. Ponieważ konstruktory obiektów głównych mogą określać tylko jeden kontekst podmiotu zabezpieczeń, dodatkowe konteksty są widoczne jako domyślne zachowanie, gdy aplikacja tworzy kontekst domeny bez określania kontenera. Ponieważ katalog aplikacji nie ma dobrze znanych kontenerów, aplikacja musi określić kontener w konstruktorze lub ArgumentException zgłaszany. Ponieważ sam nie ma kontenerów, jest zgłaszany, ArgumentException jeśli aplikacja próbuje określić kontener w konstruktorze.

W każdej wersji konstruktora, który przyjmuje nazwę użytkownika jako parametr, userName ciąg może być w różnych formatach. Trzy obsługiwane formaty NameFormats to Nt4Name, UserPrincipalName i SamAccountName. Aby uzyskać więcej informacji na temat formatów nazw, zobacz dokumentację ADS_NAME_TYPE_ENUM.

PrincipalContext(ContextType)

Źródło:

Context.cs

Inicjuje PrincipalContext nowe wystąpienie klasy o określonym typie kontekstu.

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)

Parametry

contextType

ContextType

ContextType Wartość wyliczenia określająca typ magazynu dla kontekstu głównego.

Wyjątki

ArgumentException

Podczas korzystania z kontekstu katalogu aplikacji należy określić nazwę lub kontener.

InvalidEnumArgumentException

Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.

PrincipalContext(ContextType, String)

Źródło:

Context.cs

Inicjuje PrincipalContext nowe wystąpienie klasy o określonym typie kontekstu i nazwie.

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)

Parametry

contextType

ContextType

ContextType Wartość wyliczenia określająca typ magazynu dla kontekstu głównego.

name

String

Nazwa domeny lub serwera dla Domain typów kontekstu, nazwa komputera dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.

Jeśli nazwa jest null dla Domain typu kontekstu, ten kontekst jest kontrolerem domeny domeny podmiotu zabezpieczeń użytkownika, w którym jest uruchomiony wątek. Jeśli nazwa jest null nazwą Machine typu kontekstu, jest to nazwa komputera lokalnego. Ten parametr nie może być null przeznaczony dla ApplicationDirectory typów kontekstowych.

Wyjątki

ArgumentException

Nazwa musi być określona, gdy ApplicationDirectory jest określona w parametrze contextType .

InvalidEnumArgumentException

Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.

PrincipalContext(ContextType, String, String)

Źródło:

Context.cs

Inicjuje PrincipalContext nowe wystąpienie klasy z określonym typem kontekstu, nazwą i kontenerem.

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)

Parametry

contextType

ContextType

ContextType Wartość wyliczenia określająca typ magazynu dla kontekstu głównego.

name

String

Nazwa domeny lub serwera dla Domain typów kontekstu, nazwa komputera dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.

Jeśli nazwa jest null dla Domain typu kontekstu, ten kontekst jest kontrolerem domeny domeny podmiotu zabezpieczeń użytkownika, w którym jest uruchomiony wątek. Jeśli nazwa jest null nazwą Machine typu kontekstu, jest to nazwa komputera lokalnego. Ten parametr nie może być null przeznaczony dla ApplicationDirectory typów kontekstowych.

container

String

Kontener w magazynie do użycia jako katalog główny kontekstu. Wszystkie zapytania są wykonywane w tym katalogu głównym, a wszystkie operacje wstawiania są wykonywane w tym kontenerze.

W przypadku Domain typów kontekstowych i ApplicationDirectory ten parametr jest nazwą wyróżniającą obiektu kontenera.

W przypadku Machine typów kontekstowych ten parametr musi być ustawiony na nullwartość .

Wyjątki

ArgumentException

Nie można określić kontenera Machine , gdy typ kontekstu jest określony w parametrze contextType .

W parametrze contextType należy określić ApplicationDirectory nazwę lub kontener.

InvalidEnumArgumentException

Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.

Uwagi

Element InvalidOperationException może zostać zgłoszony w kolejnych operacjach katalogu, które łączą się z serwerem, jeśli kontener określony dla Domain kontekstu podmiotu zabezpieczeń nie jest prawidłowym kontenerem. Kontener jest definiowany jako obiekt, którego klasa schematu ma klasy główne, użytkownika, grupy lub komputera, w jego możliwym atrybucieInferiors.

PrincipalContext(ContextType, String, String, ContextOptions)

Źródło:

Context.cs

Inicjuje PrincipalContext nowe wystąpienie klasy z określonym typem kontekstu, nazwą, kontenerem i opcjami kontekstu.

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)

Parametry

contextType

ContextType

ContextType Wartość wyliczenia określająca typ magazynu dla kontekstu głównego.

name

String

Nazwa domeny lub serwera dla Domain typów kontekstu, nazwa komputera dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.

Jeśli nazwa jest null dla Domain typu kontekstu, ten kontekst jest kontrolerem domeny domeny podmiotu zabezpieczeń użytkownika, w którym jest uruchomiony wątek. Jeśli nazwa jest null nazwą Machine typu kontekstu, jest to nazwa komputera lokalnego. Ten parametr nie może być null przeznaczony dla ApplicationDirectory typów kontekstowych.

container

String

Kontener w magazynie do użycia jako katalog główny kontekstu. Wszystkie zapytania są wykonywane w tym katalogu głównym, a wszystkie operacje wstawiania są wykonywane w tym kontenerze.

W przypadku Domain typów kontekstowych i ApplicationDirectory ten parametr jest nazwą wyróżniającą obiektu kontenera.

W przypadku Machine typów kontekstowych ten parametr musi być ustawiony na nullwartość .

options

ContextOptions

Kombinacja co najmniej jednej ContextOptions wartości wyliczenia określającej opcje używane do powiązania z serwerem. Jeśli ten parametr ma nullwartość , domyślne opcje to ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Pieczętowanie.

Wyjątki

ArgumentException

Nie można określić kontenera Machine , gdy typ kontekstu jest określony w parametrze contextType .

W parametrze contextType należy określić ApplicationDirectory nazwę lub kontener.

InvalidEnumArgumentException

Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.

Parametr options nie zawiera kombinacji prawidłowych ContextOptions wartości wyliczenia.

Uwagi

Element InvalidOperationException może zostać zgłoszony w kolejnych operacjach katalogu, które łączą się z serwerem, jeśli kontener określony dla Domain kontekstu podmiotu zabezpieczeń nie jest prawidłowym kontenerem. Kontener jest definiowany jako obiekt, którego klasa schematu ma klasy główne, użytkownika, grupy lub komputera, w jego możliwym atrybucieInferiors.

PrincipalContext(ContextType, String, String, String)

Źródło:

Context.cs

Inicjuje PrincipalContext nowe wystąpienie klasy z określonym typem kontekstu, nazwą, nazwą użytkownika i hasłem.

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)

Parametry

contextType

ContextType

ContextType Wartość wyliczenia określająca typ magazynu dla kontekstu głównego.

name

String

Nazwa domeny lub serwera dla Domain typów kontekstu, nazwa komputera dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.

Jeśli nazwa jest null dla Domain typu kontekstu, ten kontekst jest kontrolerem domeny domeny podmiotu zabezpieczeń użytkownika, w którym jest uruchomiony wątek. Jeśli nazwa jest null nazwą Machine typu kontekstu, jest to nazwa komputera lokalnego. Ten parametr nie może być null przeznaczony dla ApplicationDirectory typów kontekstowych.

userName

String

Nazwa użytkownika używana do łączenia się ze sklepem. Jeśli parametry userName i password są oba null, używane są poświadczenia bieżącego procesu. W przeciwnym razie oba userName elementy i password muszą mieć wartość inną niż null, a określone poświadczenia są używane do nawiązywania połączenia z magazynem.

password

String

Hasło używane do nawiązywania połączenia z magazynem. Jeśli parametry userName i password są oba null, używane są poświadczenia bieżącego procesu. W przeciwnym razie oba userName elementy i password muszą mieć wartość inną niż null, a określone poświadczenia są używane do nawiązywania połączenia z magazynem.

Wyjątki

ArgumentException

Parametry username i password muszą być null lub zawierać wartość.

Nazwa musi być określona, gdy ApplicationDirectory jest określona w parametrze contextType .

InvalidEnumArgumentException

Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.

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

Źródło:

Context.cs

Inicjuje PrincipalContext nowe wystąpienie klasy z określonym typem kontekstu, nazwą, kontenerem, nazwą użytkownika i hasłem.

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)

Parametry

contextType

ContextType

ContextType Wartość wyliczenia określająca typ magazynu dla kontekstu głównego.

name

String

Nazwa domeny lub serwera dla Domain typów kontekstu, nazwa komputera dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.

Jeśli nazwa jest null dla Domain typu kontekstu, ten kontekst jest kontrolerem domeny domeny podmiotu zabezpieczeń użytkownika, w którym jest uruchomiony wątek. Jeśli nazwa jest null nazwą Machine typu kontekstu, jest to nazwa komputera lokalnego. Ten parametr nie może być null przeznaczony dla ApplicationDirectory typów kontekstowych.

container

String

Kontener w magazynie do użycia jako katalog główny kontekstu. Wszystkie zapytania są wykonywane w tym katalogu głównym, a wszystkie operacje wstawiania są wykonywane w tym kontenerze.

W przypadku Domain typów kontekstowych i ApplicationDirectory ten parametr jest nazwą wyróżniającą obiektu kontenera.

W przypadku Machine typów kontekstowych ten parametr musi być ustawiony na nullwartość .

userName

String

Nazwa użytkownika używana do łączenia się ze sklepem. userName Jeśli parametry i password są oba null, są używane domyślne poświadczenia bieżącego podmiotu zabezpieczeń. W przeciwnym razie oba userName elementy i password muszą mieć wartość inną niż null, a określone poświadczenia są używane do nawiązywania połączenia z magazynem.

password

String

Hasło używane do nawiązywania połączenia z magazynem. userName Jeśli parametry i password są oba null, są używane domyślne poświadczenia bieżącego podmiotu zabezpieczeń. W przeciwnym razie oba userName elementy i password muszą mieć wartość inną niż null, a określone poświadczenia są używane do nawiązywania połączenia z magazynem.

Wyjątki

ArgumentException

Parametry username i password muszą być null lub zawierać wartość.

Nie można określić kontenera Machine , gdy typ kontekstu jest określony w parametrze contextType .

Wartość name lub container należy określić, gdy ApplicationDirectory parametr jest określony w parametrze contextType .

InvalidEnumArgumentException

Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.

Uwagi

Element InvalidOperationException może zostać zgłoszony w kolejnych operacjach katalogu, które łączą się z serwerem, jeśli kontener określony dla Domain kontekstu podmiotu zabezpieczeń nie jest prawidłowym kontenerem. Kontener jest definiowany jako obiekt, którego klasa schematu ma klasy główne, użytkownika, grupy lub komputera, w jego możliwym atrybucieInferiors.

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

Źródło:

Context.cs

Inicjuje PrincipalContext nowe wystąpienie klasy z określonym typem kontekstu, nazwą, kontenerem, opcjami kontekstu, nazwą użytkownika i hasłem.

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)

Parametry

contextType

ContextType

Wartość ContextType wyliczenia określająca typ magazynu dla kontekstu głównego.

name

String

Nazwa domeny lub serwera dla Domain typów kontekstowych, nazwa maszyny dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.

Jeśli nazwa jest null typem Domain kontekstu, ten kontekst jest kontrolerem domeny domeny podmiotu zabezpieczeń użytkownika, w którym jest uruchomiony wątek. Jeśli nazwa jest null typem kontekstu, jest to nazwa komputera lokalnego Machine . Ten parametr nie może być null przeznaczony dla ApplicationDirectory typów kontekstowych.

container

String

Kontener w magazynie, który ma być używany jako katalog główny kontekstu. Wszystkie zapytania są wykonywane w tym katalogu głównym, a wszystkie wstawki są wykonywane w tym kontenerze.

W przypadku Domain typów kontekstowych i ApplicationDirectory ten parametr jest nazwą wyróżniającą obiektu kontenera.

W przypadku Machine typów kontekstowych ten parametr musi być ustawiony na nullwartość .

options

ContextOptions

Kombinacja co najmniej jednej ContextOptions wartości wyliczenia opcji używanych do powiązania z serwerem. Jeśli ten parametr to null, domyślne opcje to ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Uszczelnianie.

userName

String

Nazwa użytkownika używana do nawiązywania połączenia z magazynem. Jeśli parametry userName i password są oba null, są używane domyślne poświadczenia bieżącego podmiotu zabezpieczeń. W przeciwnym razie zarówno, jak userName i password musi mieć wartość inną niż null, a określone poświadczenia są używane do nawiązywania połączenia z magazynem.

password

String

Hasło używane do nawiązywania połączenia z magazynem. Jeśli parametry userName i password są oba null, są używane domyślne poświadczenia bieżącego podmiotu zabezpieczeń. W przeciwnym razie zarówno, jak userName i password musi mieć wartość inną niż null, a określone poświadczenia są używane do nawiązywania połączenia z magazynem.

Wyjątki

ArgumentException

Parametry username i password muszą być null lub zawierać wartość.

Nie można określić kontenera Machine , gdy typ kontekstu jest określony w parametrze contextType .

Nazwa lub kontener należy określić, gdy ApplicationDirectory jest określony w parametrze contextType .

InvalidEnumArgumentException

Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.

Parametr options nie zawiera kombinacji prawidłowych ContextOptions wartości wyliczenia.

Uwagi

Może InvalidOperationException zostać zgłoszony w kolejnych wywołaniach operacji katalogu, które łączą się z serwerem, jeśli kontener określony dla Domain kontekstu podmiotu zabezpieczeń nie jest prawidłowym kontenerem. Kontener jest definiowany jako obiekt, którego klasa schematu ma klasy główne, użytkownika, grupy lub komputera, w jego możliwym atrybucieInferiors.