PrincipalContext Constructors
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Initialiseert een nieuw exemplaar van de PrincipalContext klasse.
Overloads
| Name | Description |
|---|---|
| PrincipalContext(ContextType) |
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype. |
| PrincipalContext(ContextType, String) |
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype en de naam. |
| PrincipalContext(ContextType, String, String) |
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype, de naam en de container. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype, de naam, de container en de contextopties. |
| PrincipalContext(ContextType, String, String, String) |
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype, de naam, de gebruikersnaam en het wachtwoord. |
| PrincipalContext(ContextType, String, String, String, String) |
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype, de naam, de container, de gebruikersnaam en het wachtwoord. |
| PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype, de naam, de container, de contextopties, de gebruikersnaam en het wachtwoord. |
Opmerkingen
De PrincipalContext constructors voeren validatie van de parameters en de server uit, maar proberen geen referenties te valideren.
Wanneer het principal-contextobject wordt gemaakt zonder een container op te geven, kan het worden gebruikt om meerdere afzonderlijke containers weer te geven. Eén container kan worden gebruikt als de basis van querybewerkingen, terwijl extra containers nieuw gemaakte principal-objecten kunnen bevatten. Wanneer gebruikers of groepen bijvoorbeeld worden ingevoegd in het domeincontexttype, gebruikt de Account Management-API de standaard bekende gebruikerscontainer CN=Users,DC=Fabrikam,DC=com. Wanneer computers worden ingevoegd in de store, gebruikt de API de standaardcontainer CN=Computers,DC=Fabrikam,DC=com. Houd er rekening mee dat de standaardcontainernamen kunnen worden gewijzigd door de domeinbeheerder. Omdat de principal-objectconstructors slechts één principalcontext kunnen opgeven, worden aanvullende contexten weergegeven als het standaardgedrag wanneer de toepassing een domeincontext maakt zonder een container op te geven. Omdat de toepassingsmap geen bekende containers heeft, moet de toepassing een container in de constructor opgeven of de ArgumentException container wordt gegenereerd. Omdat SAM geen containers heeft, wordt er een ArgumentException gegenereerd als de toepassing probeert een container in de constructor op te geven.
In elke versie van de constructor die een gebruikersnaam als parameter gebruikt, kan de userName tekenreeks zich in verschillende indelingen bevinden. De drie ondersteunde NameFormats zijn Nt4Name, UserPrincipalName en SamAccountName. Zie de ADS_NAME_TYPE_ENUM documentatie voor meer informatie over naamindelingen.
PrincipalContext(ContextType)
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype.
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)Parameters
- contextType
- ContextType
Een ContextType opsommingswaarde die het type archief voor de principal-context aangeeft.
Uitzonderingen
Er moet een naam of container worden opgegeven wanneer u de context van de toepassingsmap gebruikt.
De contextType parameter bevat geen geldige ContextType opsommingswaarde.
Van toepassing op
PrincipalContext(ContextType, String)
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype en de naam.
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)Parameters
- contextType
- ContextType
Een ContextType opsommingswaarde die het type archief voor de principal-context aangeeft.
- name
- String
De naam van het domein of de server voor Domain contexttypen, de computernaam voor Machine contexttypen of de naam van de server en poort die als host fungeert voor het ApplicationDirectory exemplaar.
Als de naam voor een Domain contexttype isnull, is deze context een domeincontroller voor het domein van de gebruikersprincipaal waaronder de thread wordt uitgevoerd. Als de naam voor een Machine contexttype isnull, is dit de naam van de lokale computer. Deze parameter kan niet voor ApplicationDirectory contexttypen zijnnull.
Uitzonderingen
Er moet een naam worden opgegeven wanneer ApplicationDirectory deze is opgegeven in de contextType parameter.
De contextType parameter bevat geen geldige ContextType opsommingswaarde.
Van toepassing op
PrincipalContext(ContextType, String, String)
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype, de naam en de container.
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)Parameters
- contextType
- ContextType
Een ContextType opsommingswaarde die het type archief voor de principal-context aangeeft.
- name
- String
De naam van het domein of de server voor Domain contexttypen, de computernaam voor Machine contexttypen of de naam van de server en poort die als host fungeert voor het ApplicationDirectory exemplaar.
Als de naam voor een Domain contexttype isnull, is deze context een domeincontroller voor het domein van de gebruikersprincipaal waaronder de thread wordt uitgevoerd. Als de naam voor een Machine contexttype isnull, is dit de naam van de lokale computer. Deze parameter kan niet voor ApplicationDirectory contexttypen zijnnull.
- container
- String
De container in het archief die moet worden gebruikt als de hoofdmap van de context. Alle query's worden uitgevoerd onder deze hoofdmap en alle invoegingen worden in deze container uitgevoerd.
Voor Domain en ApplicationDirectory contexttypen is deze parameter de DN-naam van een containerobject.
Voor Machine contexttypen moet deze parameter worden ingesteld op null.
Uitzonderingen
Een container kan niet worden opgegeven wanneer het Machine contexttype is opgegeven in de contextType parameter.
Er moet een naam of container worden opgegeven wanneer ApplicationDirectory deze is opgegeven in de contextType parameter.
De contextType parameter bevat geen geldige ContextType opsommingswaarde.
Opmerkingen
De InvalidOperationException kan worden gegenereerd in volgende directorybewerkingen die verbinding maken met de server als de container die is opgegeven voor een Domain principal-context geen geldige container is. Een container wordt gedefinieerd als een object waarvan de schemaklasse de principal-klassen heeft, ofwel gebruiker, groep of computer, in het kenmerk possibleInferiors.
Van toepassing op
PrincipalContext(ContextType, String, String, ContextOptions)
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype, de naam, de container en de contextopties.
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)Parameters
- contextType
- ContextType
Een ContextType opsommingswaarde die het type archief voor de principal-context aangeeft.
- name
- String
De naam van het domein of de server voor Domain contexttypen, de computernaam voor Machine contexttypen of de naam van de server en poort die als host fungeert voor het ApplicationDirectory exemplaar.
Als de naam voor een Domain contexttype isnull, is deze context een domeincontroller voor het domein van de gebruikersprincipaal waaronder de thread wordt uitgevoerd. Als de naam voor een Machine contexttype isnull, is dit de naam van de lokale computer. Deze parameter kan niet voor ApplicationDirectory contexttypen zijnnull.
- container
- String
De container in het archief die moet worden gebruikt als de hoofdmap van de context. Alle query's worden uitgevoerd onder deze hoofdmap en alle invoegingen worden in deze container uitgevoerd.
Voor Domain en ApplicationDirectory contexttypen is deze parameter de DN-naam van een containerobject.
Voor Machine contexttypen moet deze parameter worden ingesteld op null.
- options
- ContextOptions
Een combinatie van een of meer ContextOptions opsommingswaarden die de opties opgeven die worden gebruikt om verbinding te maken met de server. Als deze parameter is null, zijn de standaardopties ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Seal.
Uitzonderingen
Een container kan niet worden opgegeven wanneer het Machine contexttype is opgegeven in de contextType parameter.
Er moet een naam of container worden opgegeven wanneer ApplicationDirectory deze is opgegeven in de contextType parameter.
De contextType parameter bevat geen geldige ContextType opsommingswaarde.
De options parameter bevat geen combinatie van geldige ContextOptions opsommingswaarden.
Opmerkingen
De InvalidOperationException kan worden gegenereerd in volgende directorybewerkingen die verbinding maken met de server als de container die is opgegeven voor een Domain principal-context geen geldige container is. Een container wordt gedefinieerd als een object waarvan de schemaklasse de principal-klassen heeft, ofwel gebruiker, groep of computer, in het kenmerk possibleInferiors.
Van toepassing op
PrincipalContext(ContextType, String, String, String)
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype, de naam, de gebruikersnaam en het wachtwoord.
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)Parameters
- contextType
- ContextType
Een ContextType opsommingswaarde die het type archief voor de principal-context aangeeft.
- name
- String
De naam van het domein of de server voor Domain contexttypen, de computernaam voor Machine contexttypen of de naam van de server en poort die als host fungeert voor het ApplicationDirectory exemplaar.
Als de naam voor een Domain contexttype isnull, is deze context een domeincontroller voor het domein van de gebruikersprincipaal waaronder de thread wordt uitgevoerd. Als de naam voor een Machine contexttype isnull, is dit de naam van de lokale computer. Deze parameter kan niet voor ApplicationDirectory contexttypen zijnnull.
- userName
- String
De gebruikersnaam die wordt gebruikt om verbinding te maken met de store. Als de userName parameters password beide nullzijn, worden de referenties van het huidige proces gebruikt. Anders moeten beide userName waarden password niet null zijn en worden de referenties die ze opgeven, gebruikt om verbinding te maken met het archief.
- password
- String
Het wachtwoord dat wordt gebruikt om verbinding te maken met het archief. Als de userName parameters password beide nullzijn, worden de referenties van het huidige proces gebruikt. Anders moeten beide userName waarden password niet null zijn en worden de referenties die ze opgeven, gebruikt om verbinding te maken met het archief.
Uitzonderingen
De userName parameters password moeten een waarde zijn null of een waarde bevatten.
Er moet een naam worden opgegeven wanneer ApplicationDirectory deze is opgegeven in de contextType parameter.
De contextType parameter bevat geen geldige ContextType opsommingswaarde.
Van toepassing op
PrincipalContext(ContextType, String, String, String, String)
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype, de naam, de container, de gebruikersnaam en het wachtwoord.
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)Parameters
- contextType
- ContextType
Een ContextType opsommingswaarde die het type archief voor de principal-context aangeeft.
- name
- String
De naam van het domein of de server voor Domain contexttypen, de computernaam voor Machine contexttypen of de naam van de server en poort die als host fungeert voor het ApplicationDirectory exemplaar.
Als de naam voor een Domain contexttype isnull, is deze context een domeincontroller voor het domein van de gebruikersprincipaal waaronder de thread wordt uitgevoerd. Als de naam voor een Machine contexttype isnull, is dit de naam van de lokale computer. Deze parameter kan niet voor ApplicationDirectory contexttypen zijnnull.
- container
- String
De container in het archief die moet worden gebruikt als de hoofdmap van de context. Alle query's worden uitgevoerd onder deze hoofdmap en alle invoegingen worden in deze container uitgevoerd.
Voor Domain en ApplicationDirectory contexttypen is deze parameter de DN-naam van een containerobject.
Voor Machine contexttypen moet deze parameter worden ingesteld op null.
- userName
- String
De gebruikersnaam die wordt gebruikt om verbinding te maken met de store. Als de userName en password parameters beide nullzijn, worden de standaardreferenties van de huidige principal gebruikt. Anders moeten beide userName waarden password niet null zijn en worden de referenties die ze opgeven, gebruikt om verbinding te maken met het archief.
- password
- String
Het wachtwoord dat wordt gebruikt om verbinding te maken met het archief. Als de userName en password parameters beide nullzijn, worden de standaardreferenties van de huidige principal gebruikt. Anders moeten beide userName waarden password niet null zijn en worden de referenties die ze opgeven, gebruikt om verbinding te maken met het archief.
Uitzonderingen
De userName parameters password moeten een waarde zijn null of een waarde bevatten.
Een container kan niet worden opgegeven wanneer het Machine contexttype is opgegeven in de contextType parameter.
Een name of container moet worden opgegeven wanneer ApplicationDirectory deze is opgegeven in de contextType parameter.
De contextType parameter bevat geen geldige ContextType opsommingswaarde.
Opmerkingen
De InvalidOperationException kan worden gegenereerd in volgende directorybewerkingen die verbinding maken met de server als de container die is opgegeven voor een Domain principal-context geen geldige container is. Een container wordt gedefinieerd als een object waarvan de schemaklasse de principal-klassen heeft, ofwel gebruiker, groep of computer, in het kenmerk possibleInferiors.
Van toepassing op
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
Initialiseert een nieuw exemplaar van de PrincipalContext klasse met het opgegeven contexttype, de naam, de container, de contextopties, de gebruikersnaam en het wachtwoord.
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)Parameters
- contextType
- ContextType
Een ContextType opsommingswaarde die het type archief voor de principal-context aangeeft.
- name
- String
De naam van het domein of de server voor Domain contexttypen, de computernaam voor Machine contexttypen of de naam van de server en poort die als host fungeert voor het ApplicationDirectory exemplaar.
Als de naam voor een Domain contexttype isnull, is deze context een domeincontroller voor het domein van de gebruikersprincipaal waaronder de thread wordt uitgevoerd. Als de naam voor een Machine contexttype isnull, is dit de naam van de lokale computer. Deze parameter kan niet voor ApplicationDirectory contexttypen zijnnull.
- container
- String
De container in het archief die moet worden gebruikt als de hoofdmap van de context. Alle query's worden uitgevoerd onder deze hoofdmap en alle invoegingen worden in deze container uitgevoerd.
Voor Domain en ApplicationDirectory contexttypen is deze parameter de DN-naam van een containerobject.
Voor Machine contexttypen moet deze parameter worden ingesteld op null.
- options
- ContextOptions
Een combinatie van een of meer ContextOptions opsommingswaarden die worden gebruikt om verbinding te maken met de server. Als deze parameter is null, zijn de standaardopties ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Seal.
- userName
- String
De gebruikersnaam die wordt gebruikt om verbinding te maken met de store. Als de userName en password parameters beide nullzijn, worden de standaardreferenties van de huidige principal gebruikt. Anders moeten beide userName waarden password niet null zijn en worden de referenties die ze opgeven, gebruikt om verbinding te maken met het archief.
- password
- String
Het wachtwoord dat wordt gebruikt om verbinding te maken met het archief. Als de userName en password parameters beide nullzijn, worden de standaardreferenties van de huidige principal gebruikt. Anders moeten beide userName waarden password niet null zijn en worden de referenties die ze opgeven, gebruikt om verbinding te maken met het archief.
Uitzonderingen
De userName parameters password moeten een waarde zijn null of een waarde bevatten.
Een container kan niet worden opgegeven wanneer het Machine contexttype is opgegeven in de contextType parameter.
Er moet een naam of container worden opgegeven wanneer ApplicationDirectory deze is opgegeven in de contextType parameter.
De contextType parameter bevat geen geldige ContextType opsommingswaarde.
De options parameter bevat geen combinatie van geldige ContextOptions opsommingswaarden.
Opmerkingen
De InvalidOperationException kan worden gegenereerd in volgende directorybewerkingen die verbinding maken met de server als de container die is opgegeven voor een Domain principal-context geen geldige container is. Een container wordt gedefinieerd als een object waarvan de schemaklasse de principal-klassen heeft, ofwel gebruiker, groep of computer, in het kenmerk possibleInferiors.