PrincipalContext Costruttori

Definizione

Spazio dei nomi:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacchetto:

System.DirectoryServices.AccountManagement v8.0.0

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

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

ArgumentException

Quando si utilizza il contesto della directory dell'applicazione è necessario specificare un nome o un contenitore.

InvalidEnumArgumentException

Il parametro contextType non contiene un valore dell'enumerazione ContextType valido.

PrincipalContext(ContextType, String)

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

ArgumentException

È necessario specificare un nome quando viene specificato l'oggetto ApplicationDirectory nel parametro contextType.

InvalidEnumArgumentException

Il parametro contextType non contiene un valore dell'enumerazione ContextType valido.

PrincipalContext(ContextType, String, String)

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

ArgumentException

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.

InvalidEnumArgumentException

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.

PrincipalContext(ContextType, String, String, ContextOptions)

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

ArgumentException

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.

InvalidEnumArgumentException

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.

PrincipalContext(ContextType, String, String, String)

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

ArgumentException

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.

InvalidEnumArgumentException

Il parametro contextType non contiene un valore dell'enumerazione ContextType valido.

PrincipalContext(ContextType, String, String, String, String)

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

ArgumentException

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.

InvalidEnumArgumentException

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.

PrincipalContext(ContextType, String, String, ContextOptions, String, String)

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

ArgumentException

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.

InvalidEnumArgumentException

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.