PrincipalContext Konstruktor

Definisi

Ruang nama:

System.DirectoryServices.AccountManagement

Rakitan:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Menginisialisasi instans baru kelas PrincipalContext.

Overload

PrincipalContext(ContextType)	Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks yang ditentukan.
PrincipalContext(ContextType, String)	Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks dan nama yang ditentukan.
PrincipalContext(ContextType, String, String)	Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks, nama, dan kontainer yang ditentukan.
PrincipalContext(ContextType, String, String, ContextOptions)	Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks, nama, kontainer, dan opsi konteks yang ditentukan.
PrincipalContext(ContextType, String, String, String)	Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks, nama, nama pengguna, dan kata sandi yang ditentukan.
PrincipalContext(ContextType, String, String, String, String)	Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks, nama, kontainer, nama pengguna, dan kata sandi yang ditentukan.
PrincipalContext(ContextType, String, String, ContextOptions, String, String)	Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks, nama, kontainer, opsi konteks, nama pengguna, dan kata sandi yang ditentukan.

Keterangan

Konstruktor PrincipalContext melakukan validasi parameter dan server, tetapi tidak mencoba memvalidasi kredensial.

Ketika objek konteks utama dibuat tanpa menentukan kontainer, objek tersebut dapat digunakan untuk mewakili beberapa kontainer yang berbeda. Satu kontainer dapat digunakan sebagai dasar operasi kueri, sementara kontainer tambahan dapat menyimpan objek utama yang baru dibuat. Misalnya, ketika pengguna atau grup dimasukkan ke dalam jenis konteks domain, API Manajemen Akun menggunakan kontainer pengguna terkenal default, "CN=Users,DC=Fabrikam,DC=com". Ketika komputer disisipkan di penyimpanan, API menggunakan kontainer "CN=Computers,DC=Fabrikam,DC=com" default. Perhatikan bahwa nama kontainer default dapat diubah oleh administrator domain. Karena konstruktor objek utama hanya dapat menentukan satu konteks utama, konteks tambahan diekspos sebagai perilaku default saat aplikasi membuat konteks domain tanpa menentukan kontainer. Karena direktori aplikasi tidak memiliki kontainer terkenal, aplikasi harus menentukan kontainer di konstruktor atau ArgumentException dilemparkan. Karena SAM tidak memiliki kontainer, akan ArgumentException dilemparkan jika aplikasi mencoba menentukan kontainer di konstruktor.

Di setiap versi konstruktor yang mengambil nama pengguna sebagai parameter, userName string dapat dalam berbagai format yang berbeda. Tiga NameFormats yang didukung untuk adalah Nt4Name, UserPrincipalName, dan SamAccountName. Untuk informasi selengkapnya tentang format nama, lihat dokumentasi ADS_NAME_TYPE_ENUM.

PrincipalContext(ContextType)

Sumber:

Context.cs

Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks yang ditentukan.

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)

Parameter

contextType

ContextType

Nilai ContextType enumerasi yang menentukan jenis penyimpanan untuk konteks utama.

Pengecualian

ArgumentException

Nama atau kontainer harus ditentukan saat menggunakan konteks direktori aplikasi.

InvalidEnumArgumentException

Parameter contextType tidak berisi nilai enumerasi yang valid ContextType .

PrincipalContext(ContextType, String)

Sumber:

Context.cs

Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks dan nama yang ditentukan.

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)

Parameter

contextType

ContextType

Nilai ContextType enumerasi yang menentukan jenis penyimpanan untuk konteks utama.

name

String

Nama domain atau server untuk Domain jenis konteks, nama komputer untuk Machine jenis konteks, atau nama server dan port yang menghosting ApplicationDirectory instans.

Jika namanya null untuk Domain jenis konteks, konteks ini adalah pengendali domain untuk domain prinsipal pengguna tempat utas berjalan. Jika namanya null untuk Machine jenis konteks, ini adalah nama komputer lokal. Parameter ini tidak boleh null untuk ApplicationDirectory jenis konteks.

Pengecualian

ArgumentException

Nama harus ditentukan ketika ApplicationDirectory ditentukan dalam contextType parameter .

InvalidEnumArgumentException

Parameter contextType tidak berisi nilai enumerasi yang valid ContextType .

PrincipalContext(ContextType, String, String)

Sumber:

Context.cs

Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks, nama, dan kontainer yang ditentukan.

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)

Parameter

contextType

ContextType

Nilai ContextType enumerasi yang menentukan jenis penyimpanan untuk konteks utama.

name

String

Nama domain atau server untuk Domain jenis konteks, nama komputer untuk Machine jenis konteks, atau nama server dan port yang menghosting ApplicationDirectory instans.

Jika namanya null untuk Domain jenis konteks, konteks ini adalah pengendali domain untuk domain prinsipal pengguna tempat utas berjalan. Jika namanya null untuk Machine jenis konteks, ini adalah nama komputer lokal. Parameter ini tidak boleh null untuk ApplicationDirectory jenis konteks.

container

String

Kontainer di penyimpanan untuk digunakan sebagai akar konteks. Semua kueri dilakukan di bawah akar ini, dan semua sisipan dilakukan ke dalam kontainer ini.

Untuk Domain jenis konteks dan ApplicationDirectory , parameter ini adalah nama khusus dari objek kontainer.

Untuk Machine jenis konteks, parameter ini harus diatur ke null.

Pengecualian

ArgumentException

Kontainer tidak dapat ditentukan ketika Machine jenis konteks ditentukan dalam contextType parameter .

Nama atau kontainer harus ditentukan ketika ApplicationDirectory ditentukan dalam contextType parameter .

InvalidEnumArgumentException

Parameter contextType tidak berisi nilai enumerasi yang valid ContextType .

Keterangan

InvalidOperationException mungkin dilemparkan dalam panggilan operasi direktori berikutnya yang terhubung ke server jika kontainer yang ditentukan untuk Domain konteks utama bukan kontainer yang valid. Kontainer didefinisikan sebagai objek yang kelas skemanya memiliki kelas utama, baik pengguna, grup, atau komputer, dalam atribut possibleInferiors-nya.

PrincipalContext(ContextType, String, String, ContextOptions)

Sumber:

Context.cs

Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks, nama, kontainer, dan opsi konteks yang ditentukan.

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)

Parameter

contextType

ContextType

Nilai ContextType enumerasi yang menentukan jenis penyimpanan untuk konteks utama.

name

String

Nama domain atau server untuk Domain jenis konteks, nama komputer untuk Machine jenis konteks, atau nama server dan port yang menghosting ApplicationDirectory instans.

Jika namanya null untuk Domain jenis konteks, konteks ini adalah pengendali domain untuk domain prinsipal pengguna tempat utas berjalan. Jika namanya null untuk Machine jenis konteks, ini adalah nama komputer lokal. Parameter ini tidak boleh null untuk ApplicationDirectory jenis konteks.

container

String

Kontainer di penyimpanan untuk digunakan sebagai akar konteks. Semua kueri dilakukan di bawah akar ini, dan semua sisipan dilakukan ke dalam kontainer ini.

Untuk Domain jenis konteks dan ApplicationDirectory , parameter ini adalah nama khusus dari objek kontainer.

Untuk Machine jenis konteks, parameter ini harus diatur ke null.

options

ContextOptions

Kombinasi satu atau beberapa ContextOptions nilai enumerasi yang menentukan opsi yang digunakan untuk mengikat server. Jika parameter ini adalah null, opsi defaultnya adalah ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.

Pengecualian

ArgumentException

Kontainer tidak dapat ditentukan ketika Machine jenis konteks ditentukan dalam contextType parameter .

Nama atau kontainer harus ditentukan ketika ApplicationDirectory ditentukan dalam contextType parameter .

InvalidEnumArgumentException

Parameter contextType tidak berisi nilai enumerasi yang valid ContextType .

Parameter options tidak berisi kombinasi nilai enumerasi yang valid ContextOptions .

Keterangan

InvalidOperationException mungkin dilemparkan dalam panggilan operasi direktori berikutnya yang terhubung ke server jika kontainer yang ditentukan untuk Domain konteks utama bukan kontainer yang valid. Kontainer didefinisikan sebagai objek yang kelas skemanya memiliki kelas utama, baik pengguna, grup, atau komputer, dalam atribut possibleInferiors-nya.

PrincipalContext(ContextType, String, String, String)

Sumber:

Context.cs

Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks, nama, nama pengguna, dan kata sandi yang ditentukan.

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)

Parameter

contextType

ContextType

Nilai ContextType enumerasi yang menentukan jenis penyimpanan untuk konteks utama.

name

String

Nama domain atau server untuk Domain jenis konteks, nama komputer untuk Machine jenis konteks, atau nama server dan port yang menghosting ApplicationDirectory instans.

Jika namanya null untuk Domain jenis konteks, konteks ini adalah pengendali domain untuk domain prinsipal pengguna tempat utas berjalan. Jika namanya null untuk Machine jenis konteks, ini adalah nama komputer lokal. Parameter ini tidak boleh null untuk ApplicationDirectory jenis konteks.

userName

String

Nama pengguna yang digunakan untuk menyambungkan ke penyimpanan. userName Jika parameter dan password keduanya null, kredensial proses saat ini digunakan. Jika tidak, dan userNamepassword harus non-null, dan kredensial yang mereka tentukan digunakan untuk menyambungkan ke penyimpanan.

password

String

Kata sandi yang digunakan untuk menyambungkan ke penyimpanan. userName Jika parameter dan password keduanya null, kredensial proses saat ini digunakan. Jika tidak, dan userNamepassword harus non-null, dan kredensial yang mereka tentukan digunakan untuk menyambungkan ke penyimpanan.

Pengecualian

ArgumentException

Parameter username dan password harus berupa null atau berisi nilai.

Nama harus ditentukan ketika ApplicationDirectory ditentukan dalam contextType parameter .

InvalidEnumArgumentException

Parameter contextType tidak berisi nilai enumerasi yang valid ContextType .

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

Sumber:

Context.cs

Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks, nama, kontainer, nama pengguna, dan kata sandi yang ditentukan.

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)

Parameter

contextType

ContextType

Nilai ContextType enumerasi yang menentukan jenis penyimpanan untuk konteks utama.

name

String

Nama domain atau server untuk Domain jenis konteks, nama komputer untuk Machine jenis konteks, atau nama server dan port yang menghosting ApplicationDirectory instans.

Jika namanya null untuk Domain jenis konteks, konteks ini adalah pengendali domain untuk domain prinsipal pengguna tempat utas berjalan. Jika namanya null untuk Machine jenis konteks, ini adalah nama komputer lokal. Parameter ini tidak boleh null untuk ApplicationDirectory jenis konteks.

container

String

Kontainer di penyimpanan untuk digunakan sebagai akar konteks. Semua kueri dilakukan di bawah akar ini, dan semua sisipan dilakukan ke dalam kontainer ini.

Untuk Domain jenis konteks dan ApplicationDirectory , parameter ini adalah nama khusus dari objek kontainer.

Untuk Machine jenis konteks, parameter ini harus diatur ke null.

userName

String

Nama pengguna yang digunakan untuk menyambungkan ke penyimpanan. userName Jika parameter dan password keduanya null, kredensial default dari prinsipal saat ini digunakan. Jika tidak, dan userNamepassword harus non-null, dan kredensial yang mereka tentukan digunakan untuk menyambungkan ke penyimpanan.

password

String

Kata sandi yang digunakan untuk menyambungkan ke penyimpanan. userName Jika parameter dan password keduanya null, kredensial default dari prinsipal saat ini digunakan. Jika tidak, dan userNamepassword harus non-null, dan kredensial yang mereka tentukan digunakan untuk menyambungkan ke penyimpanan.

Pengecualian

ArgumentException

Parameter username dan password harus berupa null atau berisi nilai.

Kontainer tidak dapat ditentukan ketika Machine jenis konteks ditentukan dalam contextType parameter .

name atau container harus ditentukan ketika ApplicationDirectory ditentukan dalam contextType parameter .

InvalidEnumArgumentException

Parameter contextType tidak berisi nilai enumerasi yang valid ContextType .

Keterangan

InvalidOperationException mungkin dilemparkan dalam panggilan operasi direktori berikutnya yang terhubung ke server jika kontainer yang ditentukan untuk Domain konteks utama bukan kontainer yang valid. Kontainer didefinisikan sebagai objek yang kelas skemanya memiliki kelas utama, baik pengguna, grup, atau komputer, dalam atribut possibleInferiors-nya.

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

Sumber:

Context.cs

Menginisialisasi instans PrincipalContext baru kelas dengan jenis konteks, nama, kontainer, opsi konteks, nama pengguna, dan kata sandi yang ditentukan.

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)

Parameter

contextType

ContextType

Nilai ContextType enumerasi yang menentukan jenis penyimpanan untuk konteks utama.

name

String

Nama domain atau server untuk Domain jenis konteks, nama komputer untuk Machine jenis konteks, atau nama server dan port yang menghosting ApplicationDirectory instans.

Jika nama adalah null untuk Domain jenis konteks, konteks ini adalah pengendali domain untuk domain prinsipal pengguna tempat utas berjalan. Jika namanya null untuk Machine jenis konteks, ini adalah nama komputer lokal. Parameter ini tidak boleh null untuk ApplicationDirectory jenis konteks.

container

String

Kontainer di penyimpanan untuk digunakan sebagai akar konteks. Semua kueri dilakukan di bawah akar ini, dan semua sisipan dilakukan ke dalam kontainer ini.

Untuk Domain jenis konteks dan ApplicationDirectory , parameter ini adalah nama khusus dari objek kontainer.

Untuk Machine jenis konteks, parameter ini harus diatur ke null.

options

ContextOptions

Kombinasi satu atau beberapa ContextOptions nilai enumerasi opsi yang digunakan untuk mengikat server. Jika parameter ini adalah null, opsi defaultnya adalah ContextOptions.Negotiate | ContextOptions.Signing | ContextOptions.Sealing.

userName

String

Nama pengguna yang digunakan untuk menyambungkan ke penyimpanan. userName Jika parameter dan password keduanya null, kredensial default dari prinsipal saat ini digunakan. Jika tidak, dan userNamepassword harus non-null, dan kredensial yang mereka tentukan digunakan untuk menyambungkan ke penyimpanan.

password

String

Kata sandi yang digunakan untuk menyambungkan ke penyimpanan. userName Jika parameter dan password keduanya null, kredensial default dari prinsipal saat ini digunakan. Jika tidak, dan userNamepassword harus non-null, dan kredensial yang mereka tentukan digunakan untuk menyambungkan ke penyimpanan.

Pengecualian

ArgumentException

Parameter username dan password harus berupa null atau berisi nilai.

Kontainer tidak dapat ditentukan ketika Machine jenis konteks ditentukan dalam contextType parameter .

Nama atau kontainer harus ditentukan ketika ApplicationDirectory ditentukan dalam contextType parameter .

InvalidEnumArgumentException

Parameter contextType tidak berisi nilai enumerasi yang valid ContextType .

Parameter options tidak berisi kombinasi nilai enumerasi yang valid ContextOptions .

Keterangan

InvalidOperationException dapat dilemparkan dalam panggilan operasi direktori berikutnya yang terhubung ke server jika kontainer yang ditentukan untuk Domain konteks utama bukan kontainer yang valid. Kontainer didefinisikan sebagai objek yang kelas skemanya memiliki kelas utama, baik pengguna, grup, atau komputer, dalam atribut possibleInferiors-nya.