DataColumnCollection.Remove Metoda

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Odebere DataColumn objekt z kolekce.

Přetížení

Name	Description
Remove(DataColumn)	Odebere zadaný DataColumn objekt z kolekce.
Remove(String)	Odebere DataColumn objekt, který má zadaný název z kolekce.

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

Odebrání DataColumn .

Výjimky

ArgumentNullException

Parametr column je null.

ArgumentException

Sloupec nepatří do této kolekce.

-Or-

Sloupec je součástí relace.

-Or-

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 pojmenovaný sloupec existuje. Pokud ano, Item[] vrátí vlastnost sloupec. Metoda CanRemove pak zkontroluje, jestli se sloupec dá odebrat. Pokud ano, Remove metoda ho 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 se kolekce úspěšně změní 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 objekt, který má zadaný název z kolekce.

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ý chcete 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 testuje, CanRemove zda je možné sloupec odebrat. Pokud ano, sloupec se odebere metodou Remove .

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 se kolekce úspěšně změní přidáním nebo odebráním sloupců, dojde k CollectionChanged události.

Viz také

• Contains(String)