DataColumnCollection.Remove Yöntem

Tanım

Ad Alanı:

System.Data

Bütünleştirilmiş Kod:

System.Data.Common.dll

DataColumn Bir nesneyi koleksiyondan kaldırır.

Aşırı Yüklemeler

Remove(DataColumn)	Belirtilen DataColumn nesneyi koleksiyondan kaldırır.
Remove(String)	DataColumn Belirtilen ada sahip nesneyi koleksiyondan kaldırır.

Remove(DataColumn)

Kaynak:

DataColumnCollection.cs

Belirtilen DataColumn nesneyi koleksiyondan kaldırır.

public:
 void Remove(System::Data::DataColumn ^ column);

public void Remove (System.Data.DataColumn column);

member this.Remove : System.Data.DataColumn -> unit

Public Sub Remove (column As DataColumn)

Parametreler

column

DataColumn

Kaldırılacak DataColumn .

Özel durumlar

ArgumentNullException

column parametresidirnull.

ArgumentException

Sütun bu koleksiyona ait değil.

-Veya-

Sütun bir ilişkinin parçasıdır.

-Veya-

Başka bir sütunun ifadesi bu sütuna bağlıdır.

Örnekler

Aşağıdaki örnek, adlandırılmış bir sütunun Contains mevcut olup olmadığını belirlemek için yöntemini kullanır. Bu durumda özelliği Item[] sütunu döndürür. Yöntemi CanRemove daha sonra sütunun kaldırılıp kaldırılamayacağını denetler; kaldırılabiliyorsa yöntemi Remove sütunu kaldırır.

private void TestAndRemove(DataColumn colToRemove)
{
    DataColumnCollection columns;
    // Get the DataColumnCollection from a DataTable in a DataSet.
    columns = DataSet1.Tables["Orders"].Columns;

    if(columns.Contains(colToRemove.ColumnName))
    {
        columns.Remove(colToRemove);
    }
}

Private Sub TestAndRemove(ByVal colToRemove As DataColumn)
    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns
 
    If columns.Contains(colToRemove.ColumnName) Then
       columns.Remove(colToRemove)
    End If
End Sub

Açıklamalar

Sütun eklenerek veya kaldırılarak koleksiyon başarıyla değiştirilirse, CollectionChanged olay gerçekleşir.

Ayrıca bkz.

• Contains(String)
• CanRemove(DataColumn)
• Item[Int32]

Remove(String)

Kaynak:

DataColumnCollection.cs

DataColumn Belirtilen ada sahip nesneyi koleksiyondan kaldırır.

public:
 void Remove(System::String ^ name);

public void Remove (string name);

member this.Remove : string -> unit

Public Sub Remove (name As String)

Parametreler

name

String

Kaldırılacak sütunun adı.

Özel durumlar

ArgumentException

Koleksiyonun belirtilen ada sahip bir sütunu yok.

Örnekler

Aşağıdaki örnek ilk olarak yöntemini kullanarak Contains koleksiyonda belirli bir sütunun bulunup bulunmadığını belirler. Bulunursa, CanRemove yöntem sütunun kaldırılıp kaldırılamayacağını test eder. Bu durumda, yöntemiyle Remove sütun kaldırılır.

private void RemoveColumnByName(string columnName)
{
    // Get the DataColumnCollection from a DataTable in a DataSet.
    DataColumnCollection columns =
        ds.Tables["Suppliers"].Columns;

    if(columns.Contains(columnName))
        if(columns.CanRemove(columns[columnName]))
            columns.Remove(columnName);
}

Private Sub RemoveColumnByName(columnName As String)

    ' Get the DataColumnCollection from a DataTable in a DataSet.
    Dim columns As DataColumnCollection = _
        DataSet1.Tables("Orders").Columns

    If columns.Contains(columnName) Then 
        If columns.CanRemove(columns(columnName)) Then 
            columns.Remove(columnName)
        End If
    End If
 End Sub

Açıklamalar

Sütun eklenerek veya kaldırılarak koleksiyon başarıyla değiştirilirse, CollectionChanged olay gerçekleşir.

Ayrıca bkz.

• Contains(String)