PropertyValueCollection.Remove(Object) Yöntem

Tanım

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

public:
 void Remove(System::Object ^ value);
public void Remove (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

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

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öntemi 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.

Şunlara uygulanır