DataColumnCollection.Remove Metod

Definition

Namnområde:
System.Data
Sammansättning:
System.Data.dll
Sammansättning:
netstandard.dll

Tar bort ett DataColumn objekt från samlingen.

Överlagringar

Name Description
Remove(DataColumn)

Tar bort det angivna DataColumn objektet från samlingen.
Remove(String)

Tar bort det DataColumn objekt som har det angivna namnet från samlingen.

Remove(DataColumn)

Tar bort det angivna DataColumn objektet från samlingen.

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)

Parametrar

column
DataColumn

Att DataColumn ta bort.

Undantag

ArgumentNullException

Parametern column är null.

ArgumentException

Kolumnen tillhör inte den här samlingen.

-eller-

Kolumnen är en del av en relation.

-eller-

En annan kolumns uttryck beror på den här kolumnen.

Exempel

I följande exempel används metoden för att avgöra om det finns en namngiven Contains kolumn. I så fall Item[] returnerar egenskapen kolumnen. Metoden CanRemove kontrollerar sedan om kolumnen kan tas bort. I så fall tar metoden bort den Remove .

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

Kommentarer

Om samlingen har ändrats genom att lägga till eller ta bort kolumner inträffar händelsen CollectionChanged .

Se även

Gäller för

Remove(String)

Tar bort det DataColumn objekt som har det angivna namnet från samlingen.

public:
 void Remove(System::String ^ name);
public void Remove(string name);
member this.Remove : string -> unit
Public Sub Remove (name As String)

Parametrar

name
String

Namnet på kolumnen som ska tas bort.

Undantag

ArgumentException

Samlingen har ingen kolumn med det angivna namnet.

Exempel

I följande exempel används Contains först metoden för att avgöra om en viss kolumn finns i samlingen. Om den hittas CanRemove testar metoden om kolumnen kan tas bort. I så fall tas kolumnen bort med Remove metoden .

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

Kommentarer

Om samlingen har ändrats genom att lägga till eller ta bort kolumner inträffar händelsen CollectionChanged .

Se även

Gäller för