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
PrincipalContext(ContextType) |
Inizializza una nuova istanza della classe PrincipalContext con il tipo di contesto specificato. |
PrincipalContext(ContextType, String) |
Inizializza una nuova istanza della classe PrincipalContext con il nome e il tipo di contesto specificati. |
PrincipalContext(ContextType, String, String) |
Inizializza una nuova istanza della classe PrincipalContext con il nome, il contenitore e il tipo di contesto specificati. |
PrincipalContext(ContextType, String, String, ContextOptions) |
Inizializza una nuova istanza della classe PrincipalContext con il contenitore, il nome, il tipo di contesto e le opzioni di contesto specificati. |
PrincipalContext(ContextType, String, String, String) |
Inizializza una nuova istanza della classe PrincipalContext con nome utente, password, nome e tipo di contesto specificati. |
PrincipalContext(ContextType, String, String, String, String) |
Inizializza una nuova istanza della classe PrincipalContext con nome utente, password, nome, contenitore e tipo di contesto specificati. |
PrincipalContext(ContextType, String, String, ContextOptions, String, String) |
Inizializza una nuova istanza della classe PrincipalContext con nome utente, password, nome, contenitore, tipo di contesto e opzioni di contesto 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 delle operazioni di query, mentre altri contenitori possono contenere oggetti entità appena creati. Ad esempio, quando gli utenti o i gruppi vengono inseriti nel tipo di contesto di dominio, l'API 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 "CN=Computers,DC=Fabrikam,DC=com". Si noti che i nomi predefiniti dei contenitori possono essere modificati dall'amministratore di dominio. Poiché i costruttori di oggetti principali 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 ArgumentException viene generato. Poiché SAM non dispone di contenitori, viene generato un ArgumentException valore 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 vari formati diversi. I tre NameFormat supportati per sono Nt4Name, UserPrincipalName e SamAccountName. Per altre informazioni sui formati dei nomi, vedere la documentazione di ADS_NAME_TYPE_ENUM.
PrincipalContext(ContextType)
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
Inizializza una nuova istanza della classe PrincipalContext 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.PrincipalContext
Public Sub New (contextType As ContextType)
Parametri
- contextType
- ContextType
Valore di enumerazione ContextType che specifica il tipo di archivio per il contesto Principal.
Eccezioni
Quando si utilizza il contesto della directory dell'applicazione è necessario specificare un nome o un contenitore.
Il parametro contextType
non contiene un valore dell'enumerazione ContextType valido.
Si applica a
PrincipalContext(ContextType, String)
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
Inizializza una nuova istanza della classe PrincipalContext con il nome e il tipo di contesto 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.PrincipalContext
Public Sub New (contextType As ContextType, name As String)
Parametri
- contextType
- ContextType
Valore di enumerazione ContextType che specifica il tipo di archivio per il contesto Principal.
- name
- String
Nome del dominio o del server per i tipi di contesto Domain, nome del computer per i tipi di contesto Machine o nome del server e della porta che ospitano l'istanza ApplicationDirectory.
Se il nome è null
per un tipo di contesto Domain, questo contesto è un controller di dominio per il dominio dell'oggetto Principal dell'utente in cui è in esecuzione il thread. Se il nome è null
per un tipo di contesto Machine, questo è il nome del computer locale. Questo parametro non può essere null
per i tipi di contesto ApplicationDirectory.
Eccezioni
È necessario specificare un nome quando viene specificato l'oggetto ApplicationDirectory nel parametro contextType
.
Il parametro contextType
non contiene un valore dell'enumerazione ContextType valido.
Si applica a
PrincipalContext(ContextType, String, String)
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
Inizializza una nuova istanza della classe PrincipalContext con il nome, il contenitore e il tipo di contesto 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.PrincipalContext
Public Sub New (contextType As ContextType, name As String, container As String)
Parametri
- contextType
- ContextType
Valore di enumerazione ContextType che specifica il tipo di archivio per il contesto Principal.
- name
- String
Nome del dominio o del server per i tipi di contesto Domain, nome del computer per i tipi di contesto Machine o nome del server e della porta che ospitano l'istanza ApplicationDirectory.
Se il nome è null
per un tipo di contesto Domain, questo contesto è un controller di dominio per il dominio dell'oggetto Principal dell'utente in cui è in esecuzione il thread. Se il nome è null
per un tipo di contesto Machine, questo è il nome del computer locale. Questo parametro non può essere null
per i tipi di contesto ApplicationDirectory.
- container
- String
Il contenitore nell'archivio da utilizzare come radice del contesto. Tutte le query vengono eseguite in questa radice e tutti gli inserimenti in questo contenitore.
Per i tipi di contesto Domain e ApplicationDirectory, questo parametro è il nome distinto di un oggetto contenitore.
Per i tipi di contesto Machine, questo parametro deve essere impostato su null
.
Eccezioni
Non è possibile specificare un contenitore quando il tipo del contesto Machine è specificato nel parametro contextType
.
È necessario specificare un nome o un contenitore quando viene specificato l'oggetto ApplicationDirectory nel parametro contextType
.
Il parametro contextType
non contiene un valore dell'enumerazione ContextType valido.
Commenti
Può InvalidOperationException essere generata 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 principale, 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
Inizializza una nuova istanza della classe PrincipalContext con il contenitore, il nome, il tipo di contesto 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.PrincipalContext
Public Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions)
Parametri
- contextType
- ContextType
Valore di enumerazione ContextType che specifica il tipo di archivio per il contesto Principal.
- name
- String
Nome del dominio o del server per i tipi di contesto Domain, nome del computer per i tipi di contesto Machine o nome del server e della porta che ospitano l'istanza ApplicationDirectory.
Se il nome è null
per un tipo di contesto Domain, questo contesto è un controller di dominio per il dominio dell'oggetto Principal dell'utente in cui è in esecuzione il thread. Se il nome è null
per un tipo di contesto Machine, questo è il nome del computer locale. Questo parametro non può essere null
per i tipi di contesto ApplicationDirectory.
- container
- String
Il contenitore nell'archivio da utilizzare come radice del contesto. Tutte le query vengono eseguite in questa radice e tutti gli inserimenti in questo contenitore.
Per i tipi di contesto Domain e ApplicationDirectory, questo parametro è il nome distinto di un oggetto contenitore.
Per i tipi di contesto Machine, questo parametro deve essere impostato su null
.
- options
- ContextOptions
Combinazione di uno o più valori di enumerazione ContextOptions 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 tipo del contesto Machine è specificato nel parametro contextType
.
È necessario specificare un nome o un contenitore quando viene specificato l'oggetto ApplicationDirectory nel parametro contextType
.
Il parametro contextType
non contiene un valore dell'enumerazione ContextType valido.
Il parametro options
non contiene una combinazione di valori di enumerazione ContextOptions validi.
Commenti
Può InvalidOperationException essere generata 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 principale, 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
Inizializza una nuova istanza della classe PrincipalContext con nome utente, password, nome e tipo di contesto 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.PrincipalContext
Public Sub New (contextType As ContextType, name As String, userName As String, password As String)
Parametri
- contextType
- ContextType
Valore di enumerazione ContextType che specifica il tipo di archivio per il contesto Principal.
- name
- String
Nome del dominio o del server per i tipi di contesto Domain, nome del computer per i tipi di contesto Machine o nome del server e della porta che ospitano l'istanza ApplicationDirectory.
Se il nome è null
per un tipo di contesto Domain, questo contesto è un controller di dominio per il dominio dell'oggetto Principal dell'utente in cui è in esecuzione il thread. Se il nome è null
per un tipo di contesto Machine, questo è il nome del computer locale. Questo parametro non può essere null
per i tipi di contesto ApplicationDirectory.
- userName
- String
Il nome utente utilizzato per la connessione all'archivio. Se i parametri userName
e password
sono entrambi null
, vengono usate le credenziali del processo corrente. In caso contrario, userName
e password
devono essere non null e le credenziali che specificano vengono utilizzate per la connessione all'archivio.
- password
- String
Password utilizzata per la connessione all'archivio. Se i parametri userName
e password
sono entrambi null
, vengono usate le credenziali del processo corrente. In caso contrario, userName
e password
devono essere non null e le credenziali che specificano vengono utilizzate per la connessione all'archivio.
Eccezioni
I parametri username
e password
devono essere null
o contenere un valore.
È necessario specificare un nome quando viene specificato l'oggetto ApplicationDirectory nel parametro contextType
.
Il parametro contextType
non contiene un valore dell'enumerazione ContextType valido.
Si applica a
PrincipalContext(ContextType, String, String, String, String)
- Origine:
- Context.cs
- Origine:
- Context.cs
- Origine:
- Context.cs
Inizializza una nuova istanza della classe PrincipalContext con nome utente, password, nome, contenitore e tipo di contesto 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.PrincipalContext
Public Sub New (contextType As ContextType, name As String, container As String, userName As String, password As String)
Parametri
- contextType
- ContextType
Valore di enumerazione ContextType che specifica il tipo di archivio per il contesto Principal.
- name
- String
Nome del dominio o del server per i tipi di contesto Domain, nome del computer per i tipi di contesto Machine o nome del server e della porta che ospitano l'istanza ApplicationDirectory.
Se il nome è null
per un tipo di contesto Domain, questo contesto è un controller di dominio per il dominio dell'oggetto Principal dell'utente in cui è in esecuzione il thread. Se il nome è null
per un tipo di contesto Machine, questo è il nome del computer locale. Questo parametro non può essere null
per i tipi di contesto ApplicationDirectory.
- container
- String
Il contenitore nell'archivio da utilizzare come radice del contesto. Tutte le query vengono eseguite in questa radice e tutti gli inserimenti in questo contenitore.
Per i tipi di contesto Domain e ApplicationDirectory, questo parametro è il nome distinto di un oggetto contenitore.
Per i tipi di contesto Machine, questo parametro deve essere impostato su null
.
- userName
- String
Il nome utente utilizzato per la connessione all'archivio. Se i parametri userName
e password
sono entrambi null
, vengono usate le credenziali predefinite dell'oggetto Principal corrente. In caso contrario, userName
e password
devono essere non null e le credenziali che specificano vengono utilizzate per la connessione all'archivio.
- password
- String
Password utilizzata per la connessione all'archivio. Se i parametri userName
e password
sono entrambi null
, vengono usate le credenziali predefinite dell'oggetto Principal corrente. In caso contrario, userName
e password
devono essere non null e le credenziali che specificano vengono utilizzate per la connessione all'archivio.
Eccezioni
I parametri username
e password
devono essere null
o contenere un valore.
Non è possibile specificare un contenitore quando il tipo del contesto Machine è specificato nel parametro contextType
.
È necessario specificare un name
o un container
quando viene specificato l'oggetto ApplicationDirectory nel parametro contextType
.
Il parametro contextType
non contiene un valore dell'enumerazione ContextType valido.
Commenti
Può InvalidOperationException essere generata 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 principale, 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
Inizializza una nuova istanza della classe PrincipalContext con nome utente, password, nome, contenitore, tipo di contesto e opzioni di contesto 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.PrincipalContext
Public Sub New (contextType As ContextType, name As String, container As String, options As ContextOptions, userName As String, password As String)
Parametri
- contextType
- ContextType
Valore di enumerazione ContextType che specifica il tipo di archivio per il contesto Principal.
- name
- String
Nome del dominio o del server per i tipi di contesto Domain, nome del computer per i tipi di contesto Machine o nome del server e della porta che ospitano l'istanza ApplicationDirectory.
Se il nome è null
per un tipo di contesto Domain, questo contesto è un controller di dominio per il dominio dell'oggetto Principal dell'utente in cui è in esecuzione il thread. Se il nome è null
per un tipo di contesto Machine, questo è il nome del computer locale. Questo parametro non può essere null
per i tipi di contesto ApplicationDirectory.
- container
- String
Il contenitore nell'archivio da utilizzare come radice del contesto. Tutte le query vengono eseguite in questa radice e tutti gli inserimenti in questo contenitore.
Per i tipi di contesto Domain e ApplicationDirectory, questo parametro è il nome distinto di un oggetto contenitore.
Per i tipi di contesto Machine, questo parametro deve essere impostato su null
.
- options
- ContextOptions
Combinazione di uno o più valori di enumerazione ContextOptions che specificano le opzioni utilizzate per l'associazione al server. Se questo parametro è null
, le opzioni predefinite sono ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.
- userName
- String
Il nome utente utilizzato per la connessione all'archivio. Se i parametri userName
e password
sono entrambi null
, vengono usate le credenziali predefinite dell'oggetto Principal corrente. In caso contrario, userName
e password
devono essere non null e le credenziali che specificano vengono utilizzate per la connessione all'archivio.
- password
- String
Password utilizzata per la connessione all'archivio. Se i parametri userName
e password
sono entrambi null
, vengono usate le credenziali predefinite dell'oggetto Principal corrente. In caso contrario, userName
e password
devono essere non null e le credenziali che specificano vengono utilizzate per la connessione all'archivio.
Eccezioni
I parametri username
e password
devono essere null
o contenere un valore.
Non è possibile specificare un contenitore quando il tipo del contesto Machine è specificato nel parametro contextType
.
È necessario specificare un nome o un contenitore quando viene specificato l'oggetto ApplicationDirectory nel parametro contextType
.
Il parametro contextType
non contiene un valore dell'enumerazione ContextType valido.
Il parametro options
non contiene una combinazione di valori di enumerazione ContextOptions validi.
Commenti
Può InvalidOperationException essere generato nelle chiamate di directory successive che si connettono al server se il contenitore specificato per un contesto principale non è un Domain contenitore valido. Un contenitore viene definito come oggetto la cui classe schema ha le classi principali, utente, gruppo o computer, nel relativo attributo PossibiliInferiors.