DataColumnCollection.Remove Metoda

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Odebere DataColumn objekt z kolekce.

Přetížení

Remove(DataColumn)	Odebere zadaný DataColumn objekt z kolekce.
Remove(String)	Odebere DataColumn z kolekce objekt se zadaným názvem.

Remove(DataColumn)

Zdroj:

DataColumnCollection.cs

Odebere zadaný DataColumn objekt z kolekce.

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

Objekt, DataColumn který se má odebrat.

Výjimky

ArgumentNullException

Parametr column je null.

ArgumentException

Sloupec nepatří do této kolekce.

- nebo -

Sloupec je součástí relace.

- nebo -

Výraz jiného sloupce závisí na tomto sloupci.

Příklady

Následující příklad používá metodu Contains k určení, zda existuje pojmenovaný sloupec. Pokud ano, Item[] vrátí vlastnost sloupec . Metoda CanRemove pak zkontroluje, jestli je možné sloupec odebrat. Pokud ano, metoda ho Remove odebere.

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

Poznámky

Pokud je kolekce úspěšně změněna přidáním nebo odebráním sloupců, dojde k CollectionChanged události.

Viz také

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

Remove(String)

Zdroj:

DataColumnCollection.cs

Odebere DataColumn z kolekce objekt se zadaným názvem.

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

Název sloupce, který se má odebrat.

Výjimky

ArgumentException

Kolekce nemá sloupec se zadaným názvem.

Příklady

Následující příklad nejprve používá metodu Contains k určení, zda je v kolekci nalezen konkrétní sloupec. Pokud se najde, metoda otestuje CanRemove , jestli je možné sloupec odebrat. Pokud ano, sloupec se odebere Remove pomocí metody .

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

Poznámky

Pokud je kolekce úspěšně změněna přidáním nebo odebráním sloupců, dojde k CollectionChanged události.

Viz také

• Contains(String)