PrincipalCollection.Remove Metode

Definisi

Ruang nama:

System.DirectoryServices.AccountManagement

Rakitan:

System.DirectoryServices.AccountManagement.dll

Paket:

System.DirectoryServices.AccountManagement v8.0.0

Menghapus prinsipal yang ditentukan dari koleksi, dan mengembalikan true jika objek utama yang ditentukan adalah anggota koleksi, dan false jika tidak (dalam hal ini tidak ada operasi yang dilakukan).

Overload

Remove(ComputerPrincipal)	Menghapus objek yang ditentukan ComputerPrincipal dari koleksi, dan mengembalikan true jika ComputerPrincipal adalah anggota dari ini , dan false sebaliknya (dalam hal ini PrincipalCollectionmetode tidak melakukan operasi).
Remove(GroupPrincipal)	Menghapus objek yang ditentukan GroupPrincipal dari koleksi, dan mengembalikan true jika GroupPrincipal adalah anggota dari ini , dan false sebaliknya (dalam hal ini PrincipalCollectionmetode tidak melakukan operasi).
Remove(Principal)	Menghapus objek yang ditentukan Principal dari koleksi, dan mengembalikan true jika Principal adalah anggota dari ini , dan false sebaliknya (dalam hal ini PrincipalCollectionmetode tidak melakukan operasi).
Remove(UserPrincipal)	Menghapus objek yang ditentukan UserPrincipal dari koleksi, dan mengembalikan true jika UserPrincipal adalah anggota dari ini , dan false sebaliknya (dalam hal ini PrincipalCollectionmetode tidak melakukan operasi).
Remove(PrincipalContext, IdentityType, String)	UserPrincipal Menemukan objek yang ditentukan oleh yang diberikan PrincipalContext danidentityValue/identityType dipasangkan dari koleksi, dan mengembalikan true jika yang diidentifikasi Principal adalah anggota dari ini , dan false sebaliknya (dalam hal ini PrincipalCollectionmetode tidak melakukan operasi).

Keterangan

AddSeperti halnya , dan Contains ada empat kelebihan beban untuk fungsi ini, tetapi semuanya melakukan hal yang sama. Kelebihan beban ekstra hanya diimplementasikan untuk meningkatkan kegunaan, sehingga pengembang yang menggunakan IntelliSense melihat kelebihan beban yang mengambil UserPrincipalobjek , GroupPrincipal, atau ComputerPrincipal . Memanggil salah satu kelebihan beban Pengguna, Grup, atau Komputer sama persis dengan memanggil Principal kelebihan beban.

Remove(ComputerPrincipal)

Sumber:

PrincipalCollection.cs

Menghapus objek yang ditentukan ComputerPrincipal dari koleksi, dan mengembalikan true jika ComputerPrincipal adalah anggota dari ini , dan false sebaliknya (dalam hal ini PrincipalCollectionmetode tidak melakukan operasi).

public:
 bool Remove(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);

public bool Remove (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);

member this.Remove : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool

Public Function Remove (computer As ComputerPrincipal) As Boolean

Parameter

computer

ComputerPrincipal

Objek ComputerPrincipal.

Mengembalikan

Boolean

trueComputerPrincipal jika adalah anggota dari iniPrincipalCollection; jika tidak, false.

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian	Deskripsi
InvalidOperationException	Metode ini dipanggil pada Members koleksi untuk grup domain, dan prinsipal domain yang akan dihapus adalah anggota grup berdasarkan atributnya primaryGroupId .

Remove(GroupPrincipal)

Sumber:

PrincipalCollection.cs

Menghapus objek yang ditentukan GroupPrincipal dari koleksi, dan mengembalikan true jika GroupPrincipal adalah anggota dari ini , dan false sebaliknya (dalam hal ini PrincipalCollectionmetode tidak melakukan operasi).

public:
 bool Remove(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);

public bool Remove (System.DirectoryServices.AccountManagement.GroupPrincipal group);

member this.Remove : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool

Public Function Remove (group As GroupPrincipal) As Boolean

Parameter

group

GroupPrincipal

Objek GroupPrincipal.

Mengembalikan

Boolean

trueGroupPrincipal jika adalah anggota dari iniPrincipalCollection; jika tidak, false.

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian	Deskripsi
InvalidOperationException	Metode ini dipanggil pada Members koleksi untuk grup domain, dan prinsipal domain yang akan dihapus adalah anggota grup berdasarkan atributnya primaryGroupId .

Remove(Principal)

Sumber:

PrincipalCollection.cs

Menghapus objek yang ditentukan Principal dari koleksi, dan mengembalikan true jika Principal adalah anggota dari ini , dan false sebaliknya (dalam hal ini PrincipalCollectionmetode tidak melakukan operasi).

public:
 virtual bool Remove(System::DirectoryServices::AccountManagement::Principal ^ principal);

public bool Remove (System.DirectoryServices.AccountManagement.Principal principal);

abstract member Remove : System.DirectoryServices.AccountManagement.Principal -> bool
override this.Remove : System.DirectoryServices.AccountManagement.Principal -> bool

Public Function Remove (principal As Principal) As Boolean

Parameter

principal

Principal

Objek Principal.

Mengembalikan

Boolean

truePrincipal jika adalah anggota dari iniPrincipalCollection; jika tidak, false.

Penerapan

Remove(T)

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian	Deskripsi
InvalidOperationException	Metode ini dipanggil pada Members koleksi untuk grup domain, dan prinsipal domain yang akan dihapus adalah anggota grup berdasarkan atributnya primaryGroupId .

Remove(UserPrincipal)

Sumber:

PrincipalCollection.cs

Menghapus objek yang ditentukan UserPrincipal dari koleksi, dan mengembalikan true jika UserPrincipal adalah anggota dari ini , dan false sebaliknya (dalam hal ini PrincipalCollectionmetode tidak melakukan operasi).

public:
 bool Remove(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);

public bool Remove (System.DirectoryServices.AccountManagement.UserPrincipal user);

member this.Remove : System.DirectoryServices.AccountManagement.UserPrincipal -> bool

Public Function Remove (user As UserPrincipal) As Boolean

Parameter

user

UserPrincipal

Objek UserPrincipal.

Mengembalikan

Boolean

trueUserPrincipal jika adalah anggota dari iniPrincipalCollection; jika tidak, false.

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian	Deskripsi
InvalidOperationException	Metode ini dipanggil pada Members koleksi untuk grup domain, dan prinsipal domain yang akan dihapus adalah anggota grup berdasarkan atributnya primaryGroupId .

Remove(PrincipalContext, IdentityType, String)

Sumber:

PrincipalCollection.cs

UserPrincipal Menemukan objek yang ditentukan oleh yang diberikan PrincipalContext danidentityValue/identityType dipasangkan dari koleksi, dan mengembalikan true jika yang diidentifikasi Principal adalah anggota dari ini , dan false sebaliknya (dalam hal ini PrincipalCollectionmetode tidak melakukan operasi).

public:
 bool Remove(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);

public bool Remove (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);

member this.Remove : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> bool

Public Function Remove (context As PrincipalContext, identityType As IdentityType, identityValue As String) As Boolean

Parameter

context

PrincipalContext

Objek PrincipalContext.

identityType

IdentityType

Yang IdentityType mengidentifikasi format identityValue.

identityValue

String

Sebuah string.

Mengembalikan

Boolean

true jika yang diidentifikasi Principal adalah anggota dari ini PrincipalCollection; jika tidak, false.

Keterangan

Fungsi ini dapat melemparkan pengecualian berikut:

Pengecualian	Deskripsi
InvalidOperationException	Metode ini dipanggil pada Members koleksi untuk grup domain, dan prinsipal domain yang akan dihapus adalah anggota grup berdasarkan atributnya primaryGroupId .
NoMatchingPrincipalException	Tidak ada perwakilan yang cocok dengan parameter yang ditentukan yang ditemukan.
MultipleMatchesException	Lebih dari satu prinsipal cocok dengan parameter yang ditentukan. Secara teori, ini seharusnya tidak pernah terjadi, karena Add melemparkan pengecualian ketika ada upaya untuk menambahkan prinsipal duplikat ke koleksi. Namun, ada kemungkinan API lain membuat duplikat.
ArgumentException	identityType adalah string kosong.