PrincipalContext Konstruktory
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Inicjuje nowe wystąpienie klasy PrincipalContext.
Przeciążenia
| Nazwa | Opis |
|---|---|
| PrincipalContext(ContextType) |
Inicjuje nowe wystąpienie PrincipalContext 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 nowe wystąpienie PrincipalContext klasy z określonym typem kontekstu, nazwą i kontenerem. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Inicjuje nowe wystąpienie PrincipalContext klasy z określonym typem kontekstu, nazwą, kontenerem i opcjami kontekstu. |
| PrincipalContext(ContextType, String, String, String) |
Inicjuje nowe wystąpienie PrincipalContext klasy o określonym typie kontekstu, nazwie, nazwie, nazwie użytkownika i haśle. |
| PrincipalContext(ContextType, String, String, String, String) |
Inicjuje nowe wystąpienie PrincipalContext klasy z określonym typem kontekstu, nazwą, kontenerem, nazwą użytkownika i hasłem. |
| PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
Inicjuje nowe wystąpienie PrincipalContext klasy z określonym typem kontekstu, nazwą, kontenerem, opcjami kontekstu, nazwą użytkownika i hasłem. |
Uwagi
Konstruktory PrincipalContext przeprowadzają walidację parametrów i serwera, ale nie próbują weryfikować poświadczeń.
Gdy obiekt kontekstu podmiotu zabezpieczeń 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 podstawa operacji zapytań, podczas gdy dodatkowe kontenery mogą przechowywać nowo utworzone obiekty podmiotu zabezpieczeń. Na przykład w przypadku wstawienia 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 podczas tworzenia kontekstu domeny przez aplikację bez określania kontenera. Ponieważ katalog aplikacji nie ma dobrze znanych kontenerów, aplikacja musi określić kontener w konstruktorze ArgumentException lub zgłaszany. Ponieważ sam nie ma kontenerów, obiekt 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
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
Inicjuje nowe wystąpienie PrincipalContext 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.PrincipalContextPublic Sub New (contextType As ContextType)Parametry
- contextType
- ContextType
Wartość ContextType wyliczenia określająca typ magazynu dla kontekstu głównego.
Wyjątki
Podczas korzystania z kontekstu katalogu aplikacji należy określić nazwę lub kontener.
Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.
Dotyczy
PrincipalContext(ContextType, String)
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Ź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.PrincipalContextPublic Sub New (contextType As ContextType, name 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 kontekstu, nazwa maszyny dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.
Jeśli nazwa jest null typu Domain 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
Nazwa musi być określona, gdy ApplicationDirectory jest określona w parametrze contextType .
Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.
Dotyczy
PrincipalContext(ContextType, String, String)
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
Inicjuje nowe wystąpienie PrincipalContext 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container 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 kontekstu, nazwa maszyny dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.
Jeśli nazwa jest null typu Domain 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 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ść .
Wyjątki
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 .
Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.
Uwagi
Element InvalidOperationException może 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.
Dotyczy
PrincipalContext(ContextType, String, String, ContextOptions)
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
Inicjuje nowe wystąpienie PrincipalContext 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions)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 kontekstu, nazwa maszyny dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.
Jeśli nazwa jest null typu Domain 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 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 określającej opcje używane do powiązania z serwerem. Jeśli ten parametr to null, domyślne opcje to ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
Wyjątki
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 .
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 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.
Dotyczy
PrincipalContext(ContextType, String, String, String)
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
Inicjuje nowe wystąpienie PrincipalContext klasy o określonym typie kontekstu, nazwie, nazwie, nazwie użytkownika i haśle.
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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, 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 kontekstu, nazwa maszyny dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.
Jeśli nazwa jest null typu Domain 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 nawiązywania połączenia ze sklepem.
userName Jeśli parametry i password są oba null, używane są poświadczenia bieżącego procesu. W przeciwnym razie obie userName wartości i password muszą mieć wartość inną niż null, a określone przez nich poświadczenia są używane do nawiązywania połączenia z magazynem.
- password
- String
Hasło używane do nawiązywania połączenia ze sklepem.
userName Jeśli parametry i password są oba null, używane są poświadczenia bieżącego procesu. W przeciwnym razie obie userName wartości i password muszą mieć wartość inną niż null, a określone przez nich poświadczenia są używane do nawiązywania połączenia z magazynem.
Wyjątki
Parametry userName i password muszą być null albo zawierać wartość.
Nazwa musi być określona, gdy ApplicationDirectory jest określona w parametrze contextType .
Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.
Dotyczy
PrincipalContext(ContextType, String, String, String, String)
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
Inicjuje nowe wystąpienie PrincipalContext 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.PrincipalContextPublic Sub New (contextType As ContextType, name As String, container As String, 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 kontekstu, nazwa maszyny dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.
Jeśli nazwa jest null typu Domain 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 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ść .
- userName
- String
Nazwa użytkownika używana do nawiązywania połączenia 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 obie userName wartości i password muszą mieć wartość inną niż null, a określone przez nich poświadczenia są używane do nawiązywania połączenia z magazynem.
- password
- String
Hasło używane do nawiązywania połączenia 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 obie userName wartości i password muszą mieć wartość inną niż null, a określone przez nich poświadczenia są używane do nawiązywania połączenia z magazynem.
Wyjątki
Parametry userName i password muszą być null albo zawierać wartość.
Nie można określić kontenera Machine , gdy typ kontekstu jest określony w parametrze contextType .
Wartość name lub container musi być określona, gdy ApplicationDirectory jest określona w parametrze contextType .
Parametr contextType nie zawiera prawidłowej ContextType wartości wyliczenia.
Uwagi
Element InvalidOperationException może 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.
Dotyczy
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
- Źródło:
- Context.cs
Inicjuje nowe wystąpienie PrincipalContext 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.PrincipalContextPublic 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 kontekstu, nazwa maszyny dla Machine typów kontekstu lub nazwa serwera i portu hostowania ApplicationDirectory wystąpienia.
Jeśli nazwa jest null typu Domain 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 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.Sealing.
- userName
- String
Nazwa użytkownika używana do nawiązywania połączenia 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 obie userName wartości i password muszą mieć wartość inną niż null, a określone przez nich poświadczenia są używane do nawiązywania połączenia z magazynem.
- password
- String
Hasło używane do nawiązywania połączenia 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 obie userName wartości i password muszą mieć wartość inną niż null, a określone przez nich poświadczenia są używane do nawiązywania połączenia z magazynem.
Wyjątki
Parametry userName i password muszą być null albo 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 .
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 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.
