PropertyValueCollection.Remove(Object) Metode

Definisi

Ruang nama:

System.DirectoryServices

Rakitan:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v8.0.0

Sumber:

PropertyValueCollection.cs

Menghapus nilai properti yang ditentukan dari koleksi ini.

public:
 void Remove(System::Object ^ value);

public void Remove (object? value);

member this.Remove : obj -> unit

Public Sub Remove (value As Object)

Parameter

value

Object

Nilai properti yang akan dihapus.

Pengecualian

ArgumentNullException

Nilai properti adalah referensi null (Nothing di Visual Basic).

COMException

Terjadi kesalahan selama panggilan ke antarmuka yang mendasar.

Contoh

// Bind to the AD object  
DirectoryEntry myUser = new DirectoryEntry("LDAP://AdServer:389/CN=MyUsername,CN=Users,DC=contoso,DC=com");  

// Get the attribute  
PropertyValueCollection testAttribute = myUser.Properties["someAttribute"];  

// Find the item in the collection that we want to delete  
DNWithString dnwsItemToRemove = null;  
foreach (DNWithString dnwsItem in testAttribute)  
{  
    if (dnwsItem.StringValue.Equals("SomeValue"))  
    {  
        dnwsItemToRemove = dnwsItem;  
        break;  
    }  
}  

// Delete it  
testAttribute.Remove(dnwsItemToRemove);  

// Store the data  
myUser.CommitChanges();  

Keterangan

Saat bekerja dengan nilai properti string multinilai, Remove metode akan berhasil menghapus item yang benar. Namun, mengidentifikasi item yang benar berdasarkan nama sulit dengan nilai properti DNWithString multinilai (sebagai kelas COM DNWithString, yang digunakan untuk menyimpan item DNWithString, memiliki 2 properti string yang mewakili item). Cara untuk menghapus item tersebut adalah dengan menemukan objek dalam koleksi (dengan mengulang semua item), lalu memanggil Remove fungsi dengan pointer objek yang baru saja Anda temukan. Ini diilustrasikan dalam contoh di bawah ini.