PrincipalContext Konstruktory
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Inicializuje novou instanci PrincipalContext třídy .
Přetížení
| PrincipalContext(ContextType) |
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu. |
| PrincipalContext(ContextType, String) |
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu a názvem. |
| PrincipalContext(ContextType, String, String) |
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu, názvem a kontejnerem. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu, názvem, kontejnerem a kontextovými možnostmi. |
| PrincipalContext(ContextType, String, String, String) |
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu, názvem, uživatelským jménem a heslem. |
| PrincipalContext(ContextType, String, String, String, String) |
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu, názvem, kontejnerem, uživatelským jménem a heslem. |
| PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu, názvem, kontejnerem, možnostmi kontextu, uživatelským jménem a heslem. |
Poznámky
Konstruktory PrincipalContext provádějí ověření parametrů a serveru, ale nepokoušnou se ověřit přihlašovací údaje.
Pokud je objekt hlavního kontextu vytvořen bez zadání kontejneru, může být použit k reprezentaci více různých kontejnerů. Jeden kontejner může být použit jako základ operací dotazů, zatímco další kontejnery můžou obsahovat nově vytvořené hlavní objekty. Když se například uživatelé nebo skupiny vloží do typu kontextu domény, rozhraní API pro správu účtů použije výchozí dobře známý kontejner uživatelů CN=Users,DC=Fabrikam,DC=com. Při vložení počítačů do úložiště rozhraní API použije výchozí kontejner CN=Computers,DC=Fabrikam,DC=com. Mějte na paměti, že výchozí názvy kontejnerů může změnit správce domény. Vzhledem k tomu, že konstruktory instančního objektu mohou zadat pouze jeden kontext objektu zabezpečení, jsou další kontexty zpřístupněny jako výchozí chování, když aplikace vytvoří kontext domény bez zadání kontejneru. Vzhledem k tomu, že adresář aplikace nemá dobře známé kontejnery, musí aplikace zadat kontejner v konstruktoru nebo ArgumentException je vyvolána. Vzhledem k tomu, že SAM nemá kontejnery, ArgumentException vyvolá se v případě, že se aplikace pokusí zadat kontejner v konstruktoru.
V každé verzi konstruktoru, který jako parametr přebírá uživatelské jméno, userName může být řetězec v různých formátech. Tři podporované nameformats pro jsou Nt4Name, UserPrincipalName a SamAccountName. Další informace o formátech názvů najdete v dokumentaci k ADS_NAME_TYPE_ENUM.
PrincipalContext(ContextType)
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu.
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
Hodnota ContextType výčtu určující typ úložiště pro kontext objektu zabezpečení.
Výjimky
Při použití kontextu adresáře aplikace je nutné zadat název nebo kontejner.
Parametr contextType neobsahuje platnou ContextType hodnotu výčtu.
Platí pro
PrincipalContext(ContextType, String)
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu a názvem.
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
Hodnota ContextType výčtu určující typ úložiště pro kontext objektu zabezpečení.
- name
- String
Název domény nebo serveru pro Domain typy kontextu, název počítače pro Machine typy kontextu nebo název serveru a portu hostujícího ApplicationDirectory instanci.
Pokud je null název pro Domain typ kontextu, je tento kontext řadičem domény pro doménu objektu zabezpečení uživatele, pod kterým je vlákno spuštěno. Pokud je null název pro Machine typ kontextu, jedná se o název místního počítače. Tento parametr nemůže být null pro ApplicationDirectory kontextové typy.
Výjimky
Název musí být zadán, pokud ApplicationDirectory je zadán v parametru contextType .
Parametr contextType neobsahuje platnou ContextType hodnotu výčtu.
Platí pro
PrincipalContext(ContextType, String, String)
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu, názvem a kontejnerem.
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
Hodnota ContextType výčtu určující typ úložiště pro kontext objektu zabezpečení.
- name
- String
Název domény nebo serveru pro Domain typy kontextu, název počítače pro Machine typy kontextu nebo název serveru a portu hostujícího ApplicationDirectory instanci.
Pokud je null název pro Domain typ kontextu, je tento kontext řadičem domény pro doménu objektu zabezpečení uživatele, pod kterým je vlákno spuštěno. Pokud je null název pro Machine typ kontextu, jedná se o název místního počítače. Tento parametr nemůže být null pro ApplicationDirectory kontextové typy.
- container
- String
Kontejner v úložišti, který se má použít jako kořen kontextu. Všechny dotazy se provádějí v tomto kořenovém adresáři a všechna vložení se provádějí do tohoto kontejneru.
Pro Domain typy kontextu a ApplicationDirectory je tento parametr rozlišujícím názvem objektu kontejneru.
U Machine typů kontextu musí být tento parametr nastaven na nullhodnotu .
Výjimky
Kontejner nelze zadat, pokud je v parametru MachinecontextType zadán typ kontextu.
V parametru musí být zadán ApplicationDirectorycontextType název nebo kontejner.
Parametr contextType neobsahuje platnou ContextType hodnotu výčtu.
Poznámky
Může InvalidOperationException být vyvolána v následných operacích adresářů volání, která se připojují k serveru, pokud kontejner zadaný pro Domain hlavní kontext není platným kontejnerem. Kontejner je definován jako objekt, jehož třída schématu má ve svém atributu possibleInferiors hlavní třídy, a to buď user, group, nebo computer.
Platí pro
PrincipalContext(ContextType, String, String, ContextOptions)
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu, názvem, kontejnerem a kontextovými možnostmi.
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
Hodnota ContextType výčtu určující typ úložiště pro kontext objektu zabezpečení.
- name
- String
Název domény nebo serveru pro Domain typy kontextu, název počítače pro Machine typy kontextu nebo název serveru a portu hostujícího ApplicationDirectory instanci.
Pokud je null název pro Domain typ kontextu, je tento kontext řadičem domény pro doménu objektu zabezpečení uživatele, pod kterým je vlákno spuštěno. Pokud je null název pro Machine typ kontextu, jedná se o název místního počítače. Tento parametr nemůže být null pro ApplicationDirectory kontextové typy.
- container
- String
Kontejner v úložišti, který se má použít jako kořen kontextu. Všechny dotazy se provádějí v tomto kořenovém adresáři a všechna vložení se provádějí do tohoto kontejneru.
Pro Domain typy kontextu a ApplicationDirectory je tento parametr rozlišujícím názvem objektu kontejneru.
U Machine typů kontextu musí být tento parametr nastaven na nullhodnotu .
- options
- ContextOptions
Kombinace jedné nebo více ContextOptions hodnot výčtu určujících možnosti použité k vytvoření vazby na server. Pokud je nulltento parametr , výchozí možnosti jsou ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
Výjimky
Kontejner nelze zadat, pokud je v parametru MachinecontextType zadán typ kontextu.
V parametru musí být zadán ApplicationDirectorycontextType název nebo kontejner.
Parametr contextType neobsahuje platnou ContextType hodnotu výčtu.
Parametr options neobsahuje kombinaci platných ContextOptions hodnot výčtu.
Poznámky
Může InvalidOperationException být vyvolána v následných operacích adresářů volání, která se připojují k serveru, pokud kontejner zadaný pro Domain hlavní kontext není platným kontejnerem. Kontejner je definován jako objekt, jehož třída schématu má ve svém atributu possibleInferiors hlavní třídy, a to buď user, group, nebo computer.
Platí pro
PrincipalContext(ContextType, String, String, String)
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu, názvem, uživatelským jménem a heslem.
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
Hodnota ContextType výčtu určující typ úložiště pro kontext objektu zabezpečení.
- name
- String
Název domény nebo serveru pro Domain typy kontextu, název počítače pro Machine typy kontextu nebo název serveru a portu hostujícího ApplicationDirectory instanci.
Pokud je null název pro Domain typ kontextu, je tento kontext řadičem domény pro doménu objektu zabezpečení uživatele, pod kterým je vlákno spuštěno. Pokud je null název pro Machine typ kontextu, jedná se o název místního počítače. Tento parametr nemůže být null pro ApplicationDirectory kontextové typy.
- userName
- String
Uživatelské jméno použité k připojení k úložišti. userName Pokud jsou parametry a password , nullpoužijí se přihlašovací údaje aktuálního procesu. V opačném případě musí být hodnoty i userNamepassword jiné než null a přihlašovací údaje, které zadávají, se použijí pro připojení k úložišti.
- password
- String
Heslo použité k připojení k úložišti userName Pokud jsou parametry a password , nullpoužijí se přihlašovací údaje aktuálního procesu. V opačném případě musí být hodnoty i userNamepassword jiné než null a přihlašovací údaje, které zadávají, se použijí pro připojení k úložišti.
Výjimky
Parametry username a password musí být null nebo obsahovat hodnotu.
Název musí být zadán, pokud ApplicationDirectory je zadán v parametru contextType .
Parametr contextType neobsahuje platnou ContextType hodnotu výčtu.
Platí pro
PrincipalContext(ContextType, String, String, String, String)
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu, názvem, kontejnerem, uživatelským jménem a heslem.
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
Hodnota ContextType výčtu určující typ úložiště pro kontext objektu zabezpečení.
- name
- String
Název domény nebo serveru pro Domain typy kontextu, název počítače pro Machine typy kontextu nebo název serveru a portu hostujícího ApplicationDirectory instanci.
Pokud je null název pro Domain typ kontextu, je tento kontext řadičem domény pro doménu objektu zabezpečení uživatele, pod kterým je vlákno spuštěno. Pokud je null název pro Machine typ kontextu, jedná se o název místního počítače. Tento parametr nemůže být null pro ApplicationDirectory kontextové typy.
- container
- String
Kontejner v úložišti, který se má použít jako kořen kontextu. Všechny dotazy se provádějí v tomto kořenovém adresáři a všechna vložení se provádějí do tohoto kontejneru.
Pro Domain typy kontextu a ApplicationDirectory je tento parametr rozlišujícím názvem objektu kontejneru.
U Machine typů kontextu musí být tento parametr nastaven na nullhodnotu .
- userName
- String
Uživatelské jméno použité k připojení k úložišti. userName Pokud jsou parametry a password , nullpoužijí se výchozí přihlašovací údaje aktuálního objektu zabezpečení. V opačném případě musí být hodnoty i userNamepassword jiné než null a přihlašovací údaje, které zadávají, se použijí pro připojení k úložišti.
- password
- String
Heslo použité k připojení k úložišti userName Pokud jsou parametry a password , nullpoužijí se výchozí přihlašovací údaje aktuálního objektu zabezpečení. V opačném případě musí být hodnoty i userNamepassword jiné než null a přihlašovací údaje, které zadávají, se použijí pro připojení k úložišti.
Výjimky
Parametry username a password musí být null nebo obsahovat hodnotu.
Kontejner nelze zadat, pokud je v parametru MachinecontextType zadán typ kontextu.
A name nebo container musí být zadán, pokud ApplicationDirectory je zadán v parametru contextType .
Parametr contextType neobsahuje platnou ContextType hodnotu výčtu.
Poznámky
Může InvalidOperationException být vyvolána v následných operacích adresářů volání, která se připojují k serveru, pokud kontejner zadaný pro Domain hlavní kontext není platným kontejnerem. Kontejner je definován jako objekt, jehož třída schématu má ve svém atributu possibleInferiors hlavní třídy, a to buď user, group, nebo computer.
Platí pro
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
- Zdroj:
- Context.cs
Inicializuje novou instanci PrincipalContext třídy se zadaným typem kontextu, názvem, kontejnerem, možnostmi kontextu, uživatelským jménem a heslem.
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
Hodnota ContextType výčtu určující typ úložiště pro kontext objektu zabezpečení.
- name
- String
Název domény nebo serveru pro Domain typy kontextu, název počítače pro Machine typy kontextu nebo název serveru a portu hostujícího ApplicationDirectory instanci.
Pokud je null název pro Domain typ kontextu, tento kontext je řadič domény pro doménu objektu zabezpečení uživatele, pod kterým je vlákno spuštěno. Pokud je název pro Machine typ kontextu, jedná se null o název místního počítače. Tento parametr nemůže být null pro ApplicationDirectory kontextové typy.
- container
- String
Kontejner v úložišti, který se použije jako kořen kontextu. Všechny dotazy se provádějí v tomto kořenovém adresáři a všechna vložení se provádějí do tohoto kontejneru.
Pro Domain typy kontextu a ApplicationDirectory je tento parametr rozlišujícím názvem objektu kontejneru.
Pro Machine typy kontextu musí být tento parametr nastavený na nullhodnotu .
- options
- ContextOptions
Kombinace jedné nebo více ContextOptions hodnot výčtu možností použitých k vytvoření vazby se serverem. Pokud je nulltento parametr , výchozí možnosti jsou ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
- userName
- String
Uživatelské jméno použité k připojení k úložišti. userName Pokud jsou parametry a password , nullpoužijí se výchozí přihlašovací údaje aktuálního objektu zabezpečení. Jinak musí mít i userNamepassword jinou hodnotu než null a přihlašovací údaje, které zadají, se použijí pro připojení k úložišti.
- password
- String
Heslo použité pro připojení k úložišti. userName Pokud jsou parametry a password , nullpoužijí se výchozí přihlašovací údaje aktuálního objektu zabezpečení. Jinak musí mít i userNamepassword jinou hodnotu než null a přihlašovací údaje, které zadají, se použijí pro připojení k úložišti.
Výjimky
Parametry username a password musí být null nebo obsahovat hodnotu.
Kontejner nelze zadat, pokud je v parametru MachinecontextType zadán typ kontextu.
Při zadání v parametru contextType musí být zadán ApplicationDirectory název nebo kontejner.
Parametr contextType neobsahuje platnou ContextType hodnotu výčtu.
Parametr options neobsahuje kombinaci platných ContextOptions hodnot výčtu.
Poznámky
Může InvalidOperationException být vyvolána v následných voláních operací adresáře, která se připojují k serveru, pokud kontejner zadaný pro kontext objektu Domain zabezpečení není platný kontejner. Kontejner je definován jako objekt, jehož třída schématu má hlavní třídy, buď user, group, nebo computer, ve svém atributu possibleInferiors.
