PrincipalContext Konstruktorer
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Initierar en ny instans av PrincipalContext klassen.
Överlagringar
| Name | Description |
|---|---|
| PrincipalContext(ContextType) |
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen. |
| PrincipalContext(ContextType, String) |
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen och namnet. |
| PrincipalContext(ContextType, String, String) |
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen, namnet och containern. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen, namnet, containern och kontextalternativen. |
| PrincipalContext(ContextType, String, String, String) |
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen, namnet, användarnamnet och lösenordet. |
| PrincipalContext(ContextType, String, String, String, String) |
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen, namnet, containern, användarnamnet och lösenordet. |
| PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen, namn, container, kontextalternativ, användarnamn och lösenord. |
Kommentarer
Konstruktorerna PrincipalContext utför validering av parametrarna och servern, men försöker inte verifiera autentiseringsuppgifterna.
När huvudkontextobjektet skapas utan att ange en container kan det användas för att representera flera distinkta containrar. En container kan användas som bas för frågeåtgärder, medan ytterligare containrar kan innehålla nyligen skapade huvudobjekt. När användare eller grupper till exempel infogas i domänkontexttypen använder ACCOUNT Management-API:et den välkända standardcontainern CN=Users,DC=Fabrikam,DC=com. När datorer infogas i arkivet använder API:et standardcontainern "CN=Computers,DC=Fabrikam,DC=com". Observera att standardcontainernamnen kan ändras av domänadministratören. Eftersom huvudobjektkonstruktorerna bara kan ange en huvudkontext exponeras ytterligare kontexter som standardbeteende när programmet skapar en domänkontext utan att ange en container. Eftersom programkatalogen inte har välkända containrar måste programmet ange en container i konstruktorn eller så genereras den ArgumentException . Eftersom SAM inte har containrar utlöses en ArgumentException om programmet försöker ange en container i konstruktorn.
I varje version av konstruktorn som tar ett användarnamn som en parameter kan strängen userName vara i olika format. De tre namnformat som stöds för är Nt4Name, UserPrincipalName och SamAccountName. Mer information om namnformat finns i dokumentationen om ADS_NAME_TYPE_ENUM.
PrincipalContext(ContextType)
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen.
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)
Parametrar
- contextType
- ContextType
Ett ContextType uppräkningsvärde som anger typ av arkiv för huvudkontexten.
Undantag
Ett namn eller en container måste anges när du använder programkatalogkontexten.
Parametern contextType innehåller inget giltigt ContextType uppräkningsvärde.
Gäller för
PrincipalContext(ContextType, String)
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen och namnet.
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)
Parametrar
- contextType
- ContextType
Ett ContextType uppräkningsvärde som anger typ av arkiv för huvudkontexten.
- name
- String
Namnet på domänen eller servern för kontexttyper, datornamnet för Domain kontexttyper eller namnet på den server och port som är värd för Machine instansenApplicationDirectory.
Om namnet är null för en Domain kontexttyp är den här kontexten en domänkontrollant för domänen för det användarhuvudnamn som tråden körs under. Om namnet är null för en Machine kontexttyp är det här namnet på den lokala datorn. Den här parametern kan inte vara null för ApplicationDirectory kontexttyper.
Undantag
Ett namn måste anges när ApplicationDirectory anges i parametern contextType .
Parametern contextType innehåller inget giltigt ContextType uppräkningsvärde.
Gäller för
PrincipalContext(ContextType, String, String)
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen, namnet och containern.
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)
Parametrar
- contextType
- ContextType
Ett ContextType uppräkningsvärde som anger typ av arkiv för huvudkontexten.
- name
- String
Namnet på domänen eller servern för kontexttyper, datornamnet för Domain kontexttyper eller namnet på den server och port som är värd för Machine instansenApplicationDirectory.
Om namnet är null för en Domain kontexttyp är den här kontexten en domänkontrollant för domänen för det användarhuvudnamn som tråden körs under. Om namnet är null för en Machine kontexttyp är det här namnet på den lokala datorn. Den här parametern kan inte vara null för ApplicationDirectory kontexttyper.
- container
- String
Containern i arkivet som ska användas som rot för kontexten. Alla frågor utförs under den här roten och alla infogningar utförs i den här containern.
För Domain och ApplicationDirectory kontexttyper är den här parametern det unika namnet på ett containerobjekt.
För Machine kontexttyper måste den här parametern vara inställd på null.
Undantag
Det går inte att ange en container när Machine kontexttypen anges i parametern contextType .
Ett namn eller en container måste anges när ApplicationDirectory anges i parametern contextType .
Parametern contextType innehåller inget giltigt ContextType uppräkningsvärde.
Kommentarer
InvalidOperationException Kan genereras i efterföljande katalogåtgärder som ansluter till servern om containern som angetts för en Domain huvudkontext inte är en giltig container. En container definieras som ett objekt vars schemaklass har huvudklasserna, antingen användare, grupp eller dator, i attributet possibleInferiors.
Gäller för
PrincipalContext(ContextType, String, String, ContextOptions)
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen, namnet, containern och kontextalternativen.
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)
Parametrar
- contextType
- ContextType
Ett ContextType uppräkningsvärde som anger typ av arkiv för huvudkontexten.
- name
- String
Namnet på domänen eller servern för kontexttyper, datornamnet för Domain kontexttyper eller namnet på den server och port som är värd för Machine instansenApplicationDirectory.
Om namnet är null för en Domain kontexttyp är den här kontexten en domänkontrollant för domänen för det användarhuvudnamn som tråden körs under. Om namnet är null för en Machine kontexttyp är det här namnet på den lokala datorn. Den här parametern kan inte vara null för ApplicationDirectory kontexttyper.
- container
- String
Containern i arkivet som ska användas som rot för kontexten. Alla frågor utförs under den här roten och alla infogningar utförs i den här containern.
För Domain och ApplicationDirectory kontexttyper är den här parametern det unika namnet på ett containerobjekt.
För Machine kontexttyper måste den här parametern vara inställd på null.
- options
- ContextOptions
En kombination av ett eller flera ContextOptions uppräkningsvärden som anger de alternativ som används för att binda till servern. Om den här parametern är nullär standardalternativen ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
Undantag
Det går inte att ange en container när Machine kontexttypen anges i parametern contextType .
Ett namn eller en container måste anges när ApplicationDirectory anges i parametern contextType .
Parametern contextType innehåller inget giltigt ContextType uppräkningsvärde.
Parametern options innehåller inte en kombination av giltiga ContextOptions uppräkningsvärden.
Kommentarer
InvalidOperationException Kan genereras i efterföljande katalogåtgärder som ansluter till servern om containern som angetts för en Domain huvudkontext inte är en giltig container. En container definieras som ett objekt vars schemaklass har huvudklasserna, antingen användare, grupp eller dator, i attributet possibleInferiors.
Gäller för
PrincipalContext(ContextType, String, String, String)
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen, namnet, användarnamnet och lösenordet.
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)
Parametrar
- contextType
- ContextType
Ett ContextType uppräkningsvärde som anger typ av arkiv för huvudkontexten.
- name
- String
Namnet på domänen eller servern för kontexttyper, datornamnet för Domain kontexttyper eller namnet på den server och port som är värd för Machine instansenApplicationDirectory.
Om namnet är null för en Domain kontexttyp är den här kontexten en domänkontrollant för domänen för det användarhuvudnamn som tråden körs under. Om namnet är null för en Machine kontexttyp är det här namnet på den lokala datorn. Den här parametern kan inte vara null för ApplicationDirectory kontexttyper.
- userName
- String
Användarnamnet som används för att ansluta till butiken. Om parametrarna userName och password är båda nullanvänds autentiseringsuppgifterna för den aktuella processen. I annat fall måste både userName och password vara icke-null, och de autentiseringsuppgifter som de anger används för att ansluta till arkivet.
- password
- String
Lösenordet som används för att ansluta till arkivet. Om parametrarna userName och password är båda nullanvänds autentiseringsuppgifterna för den aktuella processen. I annat fall måste både userName och password vara icke-null, och de autentiseringsuppgifter som de anger används för att ansluta till arkivet.
Undantag
Parametrarna userName och password måste antingen vara null eller innehålla ett värde.
Ett namn måste anges när ApplicationDirectory anges i parametern contextType .
Parametern contextType innehåller inget giltigt ContextType uppräkningsvärde.
Gäller för
PrincipalContext(ContextType, String, String, String, String)
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen, namnet, containern, användarnamnet och lösenordet.
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)
Parametrar
- contextType
- ContextType
Ett ContextType uppräkningsvärde som anger typ av arkiv för huvudkontexten.
- name
- String
Namnet på domänen eller servern för kontexttyper, datornamnet för Domain kontexttyper eller namnet på den server och port som är värd för Machine instansenApplicationDirectory.
Om namnet är null för en Domain kontexttyp är den här kontexten en domänkontrollant för domänen för det användarhuvudnamn som tråden körs under. Om namnet är null för en Machine kontexttyp är det här namnet på den lokala datorn. Den här parametern kan inte vara null för ApplicationDirectory kontexttyper.
- container
- String
Containern i arkivet som ska användas som rot för kontexten. Alla frågor utförs under den här roten och alla infogningar utförs i den här containern.
För Domain och ApplicationDirectory kontexttyper är den här parametern det unika namnet på ett containerobjekt.
För Machine kontexttyper måste den här parametern vara inställd på null.
- userName
- String
Användarnamnet som används för att ansluta till butiken. Om parametrarna userName och password är båda nullanvänds standardautentiseringsuppgifterna för det aktuella huvudkontot. I annat fall måste både userName och password vara icke-null, och de autentiseringsuppgifter som de anger används för att ansluta till arkivet.
- password
- String
Lösenordet som används för att ansluta till arkivet. Om parametrarna userName och password är båda nullanvänds standardautentiseringsuppgifterna för det aktuella huvudkontot. I annat fall måste både userName och password vara icke-null, och de autentiseringsuppgifter som de anger används för att ansluta till arkivet.
Undantag
Parametrarna userName och password måste antingen vara null eller innehålla ett värde.
Det går inte att ange en container när Machine kontexttypen anges i parametern contextType .
En name eller container måste anges när ApplicationDirectory anges i parametern contextType .
Parametern contextType innehåller inget giltigt ContextType uppräkningsvärde.
Kommentarer
InvalidOperationException Kan genereras i efterföljande katalogåtgärder som ansluter till servern om containern som angetts för en Domain huvudkontext inte är en giltig container. En container definieras som ett objekt vars schemaklass har huvudklasserna, antingen användare, grupp eller dator, i attributet possibleInferiors.
Gäller för
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
- Källa:
- Context.cs
Initierar en ny instans av PrincipalContext klassen med den angivna kontexttypen, namn, container, kontextalternativ, användarnamn och lösenord.
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)
Parametrar
- contextType
- ContextType
Ett ContextType uppräkningsvärde som anger typ av arkiv för huvudkontexten.
- name
- String
Namnet på domänen eller servern för kontexttyper, datornamnet för Domain kontexttyper eller namnet på den server och port som är värd för Machine instansenApplicationDirectory.
Om namnet är null för en Domain kontexttyp är den här kontexten en domänkontrollant för domänen för det användarhuvudnamn som tråden körs under. Om namnet är null för en Machine kontexttyp är det här namnet på den lokala datorn. Den här parametern kan inte vara null för ApplicationDirectory kontexttyper.
- container
- String
Containern i arkivet som ska användas som rot för kontexten. Alla frågor utförs under den här roten och alla infogningar utförs i den här containern.
För Domain och ApplicationDirectory kontexttyper är den här parametern det unika namnet på ett containerobjekt.
För Machine kontexttyper måste den här parametern vara inställd på null.
- options
- ContextOptions
En kombination av ett eller flera ContextOptions uppräkningsvärden de alternativ som används för att binda till servern. Om den här parametern är nullär standardalternativen ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
- userName
- String
Användarnamnet som används för att ansluta till butiken. Om parametrarna userName och password är båda nullanvänds standardautentiseringsuppgifterna för det aktuella huvudkontot. I annat fall måste både userName och password vara icke-null, och de autentiseringsuppgifter som de anger används för att ansluta till arkivet.
- password
- String
Lösenordet som används för att ansluta till arkivet. Om parametrarna userName och password är båda nullanvänds standardautentiseringsuppgifterna för det aktuella huvudkontot. I annat fall måste både userName och password vara icke-null, och de autentiseringsuppgifter som de anger används för att ansluta till arkivet.
Undantag
Parametrarna userName och password måste antingen vara null eller innehålla ett värde.
Det går inte att ange en container när Machine kontexttypen anges i parametern contextType .
Ett namn eller en container måste anges när ApplicationDirectory anges i parametern contextType .
Parametern contextType innehåller inget giltigt ContextType uppräkningsvärde.
Parametern options innehåller inte en kombination av giltiga ContextOptions uppräkningsvärden.
Kommentarer
InvalidOperationException Kan genereras i efterföljande katalogåtgärder som ansluter till servern om containern som angetts för en Domain huvudkontext inte är en giltig container. En container definieras som ett objekt vars schemaklass har huvudklasserna, antingen användare, grupp eller dator, i attributet possibleInferiors.