Bagikan melalui


PrincipalCollection.Remove Metode

Definisi

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
Sumber:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Remove (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
member this.Remove : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool
[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.ComputerPrincipal -> bool
Public Function Remove (computer As ComputerPrincipal) As Boolean

Parameter

Mengembalikan

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

Atribut

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 .

Berlaku untuk

Remove(GroupPrincipal)

Sumber:
PrincipalCollection.cs
Sumber:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Remove (System.DirectoryServices.AccountManagement.GroupPrincipal group);
member this.Remove : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool
[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.GroupPrincipal -> bool
Public Function Remove (group As GroupPrincipal) As Boolean

Parameter

Mengembalikan

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

Atribut

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 .

Berlaku untuk

Remove(Principal)

Sumber:
PrincipalCollection.cs
Sumber:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Remove (System.DirectoryServices.AccountManagement.Principal principal);
abstract member Remove : System.DirectoryServices.AccountManagement.Principal -> bool
override this.Remove : System.DirectoryServices.AccountManagement.Principal -> bool
[<System.Security.SecurityCritical>]
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

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

Penerapan

Atribut

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 .

Berlaku untuk

Remove(UserPrincipal)

Sumber:
PrincipalCollection.cs
Sumber:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
public bool Remove (System.DirectoryServices.AccountManagement.UserPrincipal user);
member this.Remove : System.DirectoryServices.AccountManagement.UserPrincipal -> bool
[<System.Security.SecurityCritical>]
member this.Remove : System.DirectoryServices.AccountManagement.UserPrincipal -> bool
Public Function Remove (user As UserPrincipal) As Boolean

Parameter

Mengembalikan

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

Atribut

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 .

Berlaku untuk

Remove(PrincipalContext, IdentityType, String)

Sumber:
PrincipalCollection.cs
Sumber:
PrincipalCollection.cs
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);
[System.Security.SecurityCritical]
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
[<System.Security.SecurityCritical>]
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

identityType
IdentityType

Yang IdentityType mengidentifikasi format identityValue.

identityValue
String

Sebuah string.

Mengembalikan

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

Atribut

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.

Berlaku untuk