PropertyValueCollection.Remove(Object) メソッド

  • リファレンス

定義

名前空間:
System.DirectoryServices
アセンブリ:
System.DirectoryServices.dll
パッケージ:
System.DirectoryServices v6.0.0
パッケージ:
System.DirectoryServices v7.0.0
パッケージ:
System.DirectoryServices v8.0.0
パッケージ:
System.DirectoryServices v9.0.0-preview.2.24128.5
ソース:
PropertyValueCollection.cs
ソース:
PropertyValueCollection.cs
ソース:
PropertyValueCollection.cs

このコレクションから指定したプロパティ値を削除します。

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)

パラメーター

value
Object

削除するプロパティ値。

例外

ArgumentNullException

プロパティ値は null 参照 (Visual Basic ではNothing ) です。

COMException

基になるインターフェイスへの呼び出し中にエラーが発生しました。

例

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

注釈

複数値の文字列プロパティ値を使用する場合、 Remove メソッドは正しい項目を正常に削除します。 ただし、複数値の DNWithString プロパティ値では、名前で正しいアイテムを識別することは困難です (DNWithString アイテムの格納に使用される DNWithString COM クラスには、アイテムを表す 2 つの文字列プロパティがあります)。 このような項目を削除する方法は、コレクション内のオブジェクトを検索し (すべての項目をループして)、見つけたオブジェクトのポインターを使用して関数を呼び出 Remove す方法です。 これは、次の例に示されています。

適用対象