PropertyValueCollection.Remove(Object) Yöntem

Tanım

Ad Alanı:

System.DirectoryServices

Bütünleştirilmiş Kod:

System.DirectoryServices.dll

Paket:

System.DirectoryServices v11.0.0-preview.5.26302.115

Kaynak:

PropertyValueCollection.cs

Belirtilen özellik değerini bu koleksiyondan kaldırır.

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

public void Remove(object? value);

member this.Remove : obj -> unit

Public Sub Remove (value As Object)

Parametreler

value

Object

Kaldırılacak özellik değeri.

Özel durumlar

ArgumentNullException

Özellik değeri null bir başvurudur (Visual Basic Nothing).

COMException

Temel alınan arabirime yapılan çağrı sırasında bir hata oluştu.

Örnekler

// 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();

Açıklamalar

Çok değerli bir dize özellik değeriyle çalışırken yöntem Remove doğru öğeyi başarıyla kaldırır. Ancak, çok değerli bir DNWithString özellik değeriyle doğru öğeleri ada göre tanımlamak zordur (DNWithString öğelerini depolamak için kullanılan DNWithString COM sınıfı, öğeyi temsil eden 2 dize özelliğine sahiptir). Bu tür öğeleri kaldırmanın yolu, koleksiyondaki nesneyi bulmaktır (tüm öğelere döngü yaparak), ardından az önce bulduğunuz nesne işaretçisiyle işlevi çağırmaktır Remove . Bu, aşağıdaki örnekte gösterilmiştir.