PrincipalContext Costruttori
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inizializza una nuova istanza della classe PrincipalContext.
Overload
| Nome | Descrizione |
|---|---|
| PrincipalContext(ContextType) |
Inizializza una nuova istanza della PrincipalContext classe con il tipo di contesto specificato. |
| PrincipalContext(ContextType, String) |
Inizializza una nuova istanza della PrincipalContext classe con il tipo di contesto e il nome specificati. |
| PrincipalContext(ContextType, String, String) |
Inizializza una nuova istanza della PrincipalContext classe con il tipo di contesto, il nome e il contenitore specificati. |
| PrincipalContext(ContextType, String, String, ContextOptions) |
Inizializza una nuova istanza della PrincipalContext classe con il tipo di contesto, il nome, il contenitore e le opzioni di contesto specificati. |
| PrincipalContext(ContextType, String, String, String) |
Inizializza una nuova istanza della classe con il tipo di contesto, il nome, il nome utente e la PrincipalContext password specificati. |
| PrincipalContext(ContextType, String, String, String, String) |
Inizializza una nuova istanza della classe con il tipo di contesto, il nome, il contenitore, il nome utente e la PrincipalContext password specificati. |
| PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
Inizializza una nuova istanza della PrincipalContext classe con il tipo di contesto, il nome, il contenitore, le opzioni di contesto, il nome utente e la password specificati. |
Commenti
I PrincipalContext costruttori eseguono la convalida dei parametri e del server, ma non tentano di convalidare le credenziali.
Quando l'oggetto contesto principale viene creato senza specificare un contenitore, può essere usato per rappresentare più contenitori distinti. Un contenitore può essere usato come base di operazioni di query, mentre altri contenitori possono contenere oggetti principal appena creati. Ad esempio, quando gli utenti o i gruppi vengono inseriti nel tipo di contesto di dominio, l'API Di gestione account usa il contenitore utente noto predefinito, "CN=Users,DC=Fabrikam,DC=com". Quando i computer vengono inseriti nell'archivio, l'API usa il contenitore predefinito "CN=Computers,DC=Fabrikam,DC=com". Si noti che i nomi dei contenitori predefiniti possono essere modificati dall'amministratore di dominio. Poiché i costruttori di oggetti principale possono specificare un solo contesto principale, i contesti aggiuntivi vengono esposti come comportamento predefinito quando l'applicazione crea un contesto di dominio senza specificare un contenitore. Poiché la directory dell'applicazione non dispone di contenitori noti, l'applicazione deve specificare un contenitore nel costruttore o viene generata l'eccezione ArgumentException . Poiché SAM non dispone di contenitori, viene generata un'eccezione ArgumentException se l'applicazione tenta di specificare un contenitore nel costruttore.
In ogni versione del costruttore che accetta un nome utente come parametro, la userName stringa può essere in diversi formati. I tre formati NameFormat supportati per sono Nt4Name, UserPrincipalName e SamAccountName. Per altre informazioni sui formati dei nomi, vedere la documentazione ADS_NAME_TYPE_ENUM.
PrincipalContext(ContextType)
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
Inizializza una nuova istanza della PrincipalContext classe con il tipo di contesto specificato.
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)Parametri
- contextType
- ContextType
Valore ContextType di enumerazione che specifica il tipo di archivio per il contesto principale.
Eccezioni
È necessario specificare un nome o un contenitore quando si usa il contesto della directory dell'applicazione.
Il contextType parametro non contiene un valore di enumerazione valido ContextType .
Si applica a
PrincipalContext(ContextType, String)
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
Inizializza una nuova istanza della PrincipalContext classe con il tipo di contesto e il nome specificati.
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)Parametri
- contextType
- ContextType
Valore ContextType di enumerazione che specifica il tipo di archivio per il contesto principale.
- name
- String
Nome del dominio o del server per Domain i tipi di contesto, il nome del computer per Machine i tipi di contesto o il nome del server e della porta che ospita l'istanza ApplicationDirectory .
Se il nome è null per un Domain tipo di contesto, questo contesto è un controller di dominio per il dominio dell'entità utente in cui è in esecuzione il thread. Se il nome è null per un Machine tipo di contesto, si tratta del nome del computer locale. Questo parametro non può essere null per ApplicationDirectory i tipi di contesto.
Eccezioni
È necessario specificare un nome quando ApplicationDirectory viene specificato nel contextType parametro .
Il contextType parametro non contiene un valore di enumerazione valido ContextType .
Si applica a
PrincipalContext(ContextType, String, String)
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
Inizializza una nuova istanza della PrincipalContext classe con il tipo di contesto, il nome e il contenitore specificati.
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)Parametri
- contextType
- ContextType
Valore ContextType di enumerazione che specifica il tipo di archivio per il contesto principale.
- name
- String
Nome del dominio o del server per Domain i tipi di contesto, il nome del computer per Machine i tipi di contesto o il nome del server e della porta che ospita l'istanza ApplicationDirectory .
Se il nome è null per un Domain tipo di contesto, questo contesto è un controller di dominio per il dominio dell'entità utente in cui è in esecuzione il thread. Se il nome è null per un Machine tipo di contesto, si tratta del nome del computer locale. Questo parametro non può essere null per ApplicationDirectory i tipi di contesto.
- container
- String
Contenitore nell'archivio da usare come radice del contesto. Tutte le query vengono eseguite in questa radice e tutti gli inserimenti vengono eseguiti in questo contenitore.
Per Domain i tipi di contesto e ApplicationDirectory , questo parametro è il nome distinto di un oggetto contenitore.
Per Machine i tipi di contesto, questo parametro deve essere impostato su null.
Eccezioni
Non è possibile specificare un contenitore quando il Machine tipo di contesto viene specificato nel contextType parametro .
È necessario specificare un nome o un contenitore quando ApplicationDirectory viene specificato nel contextType parametro .
Il contextType parametro non contiene un valore di enumerazione valido ContextType .
Commenti
L'oggetto InvalidOperationException può essere generato nelle chiamate di directory successive che si connettono al server se il contenitore specificato per un Domain contesto principale non è un contenitore valido. Un contenitore viene definito come oggetto la cui classe dello schema ha le classi principali, utente, gruppo o computer, nel relativo attributo possibleInferiors.
Si applica a
PrincipalContext(ContextType, String, String, ContextOptions)
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
Inizializza una nuova istanza della PrincipalContext classe con il tipo di contesto, il nome, il contenitore e le opzioni di contesto specificati.
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)Parametri
- contextType
- ContextType
Valore ContextType di enumerazione che specifica il tipo di archivio per il contesto principale.
- name
- String
Nome del dominio o del server per Domain i tipi di contesto, il nome del computer per Machine i tipi di contesto o il nome del server e della porta che ospita l'istanza ApplicationDirectory .
Se il nome è null per un Domain tipo di contesto, questo contesto è un controller di dominio per il dominio dell'entità utente in cui è in esecuzione il thread. Se il nome è null per un Machine tipo di contesto, si tratta del nome del computer locale. Questo parametro non può essere null per ApplicationDirectory i tipi di contesto.
- container
- String
Contenitore nell'archivio da usare come radice del contesto. Tutte le query vengono eseguite in questa radice e tutti gli inserimenti vengono eseguiti in questo contenitore.
Per Domain i tipi di contesto e ApplicationDirectory , questo parametro è il nome distinto di un oggetto contenitore.
Per Machine i tipi di contesto, questo parametro deve essere impostato su null.
- options
- ContextOptions
Combinazione di uno o più ContextOptions valori di enumerazione che specificano le opzioni utilizzate per l'associazione al server. Se questo parametro è null, le opzioni predefinite sono ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
Eccezioni
Non è possibile specificare un contenitore quando il Machine tipo di contesto viene specificato nel contextType parametro .
È necessario specificare un nome o un contenitore quando ApplicationDirectory viene specificato nel contextType parametro .
Il contextType parametro non contiene un valore di enumerazione valido ContextType .
Il options parametro non contiene una combinazione di valori di enumerazione validi ContextOptions .
Commenti
L'oggetto InvalidOperationException può essere generato nelle chiamate di directory successive che si connettono al server se il contenitore specificato per un Domain contesto principale non è un contenitore valido. Un contenitore viene definito come oggetto la cui classe dello schema ha le classi principali, utente, gruppo o computer, nel relativo attributo possibleInferiors.
Si applica a
PrincipalContext(ContextType, String, String, String)
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
Inizializza una nuova istanza della classe con il tipo di contesto, il nome, il nome utente e la PrincipalContext password specificati.
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)Parametri
- contextType
- ContextType
Valore ContextType di enumerazione che specifica il tipo di archivio per il contesto principale.
- name
- String
Nome del dominio o del server per Domain i tipi di contesto, il nome del computer per Machine i tipi di contesto o il nome del server e della porta che ospita l'istanza ApplicationDirectory .
Se il nome è null per un Domain tipo di contesto, questo contesto è un controller di dominio per il dominio dell'entità utente in cui è in esecuzione il thread. Se il nome è null per un Machine tipo di contesto, si tratta del nome del computer locale. Questo parametro non può essere null per ApplicationDirectory i tipi di contesto.
- userName
- String
Nome utente usato per connettersi all'archivio. Se i userName parametri e password sono entrambi null, vengono usate le credenziali del processo corrente. In caso contrario, sia userName che password devono essere non Null e le credenziali specificate vengono usate per connettersi all'archivio.
- password
- String
Password utilizzata per connettersi all'archivio. Se i userName parametri e password sono entrambi null, vengono usate le credenziali del processo corrente. In caso contrario, sia userName che password devono essere non Null e le credenziali specificate vengono usate per connettersi all'archivio.
Eccezioni
I userName parametri e password devono essere null o contenere un valore.
È necessario specificare un nome quando ApplicationDirectory viene specificato nel contextType parametro .
Il contextType parametro non contiene un valore di enumerazione valido ContextType .
Si applica a
PrincipalContext(ContextType, String, String, String, String)
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
Inizializza una nuova istanza della classe con il tipo di contesto, il nome, il contenitore, il nome utente e la PrincipalContext password specificati.
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)Parametri
- contextType
- ContextType
Valore ContextType di enumerazione che specifica il tipo di archivio per il contesto principale.
- name
- String
Nome del dominio o del server per Domain i tipi di contesto, il nome del computer per Machine i tipi di contesto o il nome del server e della porta che ospita l'istanza ApplicationDirectory .
Se il nome è null per un Domain tipo di contesto, questo contesto è un controller di dominio per il dominio dell'entità utente in cui è in esecuzione il thread. Se il nome è null per un Machine tipo di contesto, si tratta del nome del computer locale. Questo parametro non può essere null per ApplicationDirectory i tipi di contesto.
- container
- String
Contenitore nell'archivio da usare come radice del contesto. Tutte le query vengono eseguite in questa radice e tutti gli inserimenti vengono eseguiti in questo contenitore.
Per Domain i tipi di contesto e ApplicationDirectory , questo parametro è il nome distinto di un oggetto contenitore.
Per Machine i tipi di contesto, questo parametro deve essere impostato su null.
- userName
- String
Nome utente usato per connettersi all'archivio. Se i userName parametri e password sono entrambi null, vengono usate le credenziali predefinite dell'entità corrente. In caso contrario, sia userName che password devono essere non Null e le credenziali specificate vengono usate per connettersi all'archivio.
- password
- String
Password utilizzata per connettersi all'archivio. Se i userName parametri e password sono entrambi null, vengono usate le credenziali predefinite dell'entità corrente. In caso contrario, sia userName che password devono essere non Null e le credenziali specificate vengono usate per connettersi all'archivio.
Eccezioni
I userName parametri e password devono essere null o contenere un valore.
Non è possibile specificare un contenitore quando il Machine tipo di contesto viene specificato nel contextType parametro .
Un name oggetto o container deve essere specificato quando ApplicationDirectory viene specificato nel contextType parametro .
Il contextType parametro non contiene un valore di enumerazione valido ContextType .
Commenti
L'oggetto InvalidOperationException può essere generato nelle chiamate di directory successive che si connettono al server se il contenitore specificato per un Domain contesto principale non è un contenitore valido. Un contenitore viene definito come oggetto la cui classe dello schema ha le classi principali, utente, gruppo o computer, nel relativo attributo possibleInferiors.
Si applica a
PrincipalContext(ContextType, String, String, ContextOptions, String, String)
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
Inizializza una nuova istanza della PrincipalContext classe con il tipo di contesto, il nome, il contenitore, le opzioni di contesto, il nome utente e la password specificati.
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)Parametri
- contextType
- ContextType
Valore ContextType di enumerazione che specifica il tipo di archivio per il contesto principale.
- name
- String
Nome del dominio o del server per Domain i tipi di contesto, il nome del computer per Machine i tipi di contesto o il nome del server e della porta che ospita l'istanza ApplicationDirectory .
Se il nome è null per un Domain tipo di contesto, questo contesto è un controller di dominio per il dominio dell'entità utente in cui è in esecuzione il thread. Se il nome è null per un Machine tipo di contesto, si tratta del nome del computer locale. Questo parametro non può essere null per ApplicationDirectory i tipi di contesto.
- container
- String
Contenitore nell'archivio da usare come radice del contesto. Tutte le query vengono eseguite in questa radice e tutti gli inserimenti vengono eseguiti in questo contenitore.
Per Domain i tipi di contesto e ApplicationDirectory , questo parametro è il nome distinto di un oggetto contenitore.
Per Machine i tipi di contesto, questo parametro deve essere impostato su null.
- options
- ContextOptions
Combinazione di uno o più ContextOptions valori di enumerazione delle opzioni utilizzate per l'associazione al server. Se questo parametro è null, le opzioni predefinite sono ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
- userName
- String
Nome utente usato per connettersi all'archivio. Se i userName parametri e password sono entrambi null, vengono usate le credenziali predefinite dell'entità corrente. In caso contrario, sia userName che password devono essere non Null e le credenziali specificate vengono usate per connettersi all'archivio.
- password
- String
Password utilizzata per connettersi all'archivio. Se i userName parametri e password sono entrambi null, vengono usate le credenziali predefinite dell'entità corrente. In caso contrario, sia userName che password devono essere non Null e le credenziali specificate vengono usate per connettersi all'archivio.
Eccezioni
I userName parametri e password devono essere null o contenere un valore.
Non è possibile specificare un contenitore quando il Machine tipo di contesto viene specificato nel contextType parametro .
È necessario specificare un nome o un contenitore quando ApplicationDirectory viene specificato nel contextType parametro .
Il contextType parametro non contiene un valore di enumerazione valido ContextType .
Il options parametro non contiene una combinazione di valori di enumerazione validi ContextOptions .
Commenti
L'oggetto InvalidOperationException può essere generato nelle chiamate di directory successive che si connettono al server se il contenitore specificato per un Domain contesto principale non è un contenitore valido. Un contenitore viene definito come oggetto la cui classe dello schema ha le classi principali, utente, gruppo o computer, nel relativo attributo possibleInferiors.
