DataColumnCollection.Remove Metoda

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

DataColumn Usuwa obiekt z kolekcji.

Przeciążenia

Remove(DataColumn)	Usuwa określony DataColumn obiekt z kolekcji.
Remove(String)	DataColumn Usuwa obiekt o określonej nazwie z kolekcji.

Remove(DataColumn)

Źródło:

DataColumnCollection.cs

Usuwa określony DataColumn obiekt z kolekcji.

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)

Parametry

column

DataColumn

Element DataColumn do usunięcia.

Wyjątki

ArgumentNullException

Parametr column to null.

ArgumentException

Kolumna nie należy do tej kolekcji.

— Lub —

Kolumna jest częścią relacji.

— Lub —

Wyrażenie innej kolumny zależy od tej kolumny.

Przykłady

W poniższym przykładzie użyto metody w Contains celu określenia, czy istnieje nazwana kolumna. Jeśli tak, Item[] właściwość zwraca kolumnę. Następnie metoda sprawdza, czy można usunąć kolumnę. Jeśli CanRemove tak, Remove metoda ją usunie.

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

Uwagi

Jeśli kolekcja zostanie pomyślnie zmieniona przez dodanie lub usunięcie kolumn, CollectionChanged zdarzenie zostanie wykonane.

Zobacz też

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

Remove(String)

Źródło:

DataColumnCollection.cs

DataColumn Usuwa obiekt o określonej nazwie z kolekcji.

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

public void Remove (string name);

member this.Remove : string -> unit

Public Sub Remove (name As String)

Parametry

name

String

Nazwa kolumny do usunięcia.

Wyjątki

ArgumentException

Kolekcja nie ma kolumny o określonej nazwie.

Przykłady

W poniższym przykładzie użyto metody , Contains aby określić, czy określona kolumna znajduje się w kolekcji. Jeśli zostanie znaleziona, metoda sprawdza, CanRemove czy można usunąć kolumnę. Jeśli tak, kolumna zostanie usunięta z Remove metodą .

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

Uwagi

Jeśli kolekcja zostanie pomyślnie zmieniona przez dodanie lub usunięcie kolumn, CollectionChanged zdarzenie zostanie wykonane.

Zobacz też

• Contains(String)