DataColumnCollection.Remove Metodo

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Rimuove un oggetto DataColumn dalla raccolta.

Overload

Remove(DataColumn)	Rimuove l'oggetto DataColumn specificato dalla raccolta.
Remove(String)	Rimuove l'oggetto DataColumn con il nome specificato dall'insieme.

Remove(DataColumn)

Source:

DataColumnCollection.cs

Rimuove l'oggetto DataColumn specificato dalla raccolta.

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)

Parametri

column

DataColumn

Oggetto DataColumn da rimuovere.

Eccezioni

ArgumentNullException

Il valore del parametro column è null.

ArgumentException

La colonna non appartiene a questo insieme.

Oppure

La colonna fa parte di una relazione.

Oppure

L'espressione di un'altra colonna dipende da questa colonna.

Esempio

Nell'esempio seguente viene usato il Contains metodo per determinare se esiste una colonna denominata. In tal caso, la Item[] proprietà restituisce la colonna. Il CanRemove metodo verifica quindi se la colonna può essere rimossa. In tal caso, il Remove metodo lo rimuove.

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

Commenti

Se la raccolta viene modificata correttamente aggiungendo o rimuovendo colonne, si verifica l'evento CollectionChanged .

Vedi anche

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

Remove(String)

Source:

DataColumnCollection.cs

Rimuove l'oggetto DataColumn con il nome specificato dall'insieme.

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

public void Remove (string name);

member this.Remove : string -> unit

Public Sub Remove (name As String)

Parametri

name

String

Nome della colonna da rimuovere.

Eccezioni

ArgumentException

L'insieme non dispone di una colonna con il nome specificato.

Esempio

Nell'esempio seguente viene usato innanzitutto il Contains metodo per determinare se nella raccolta viene trovata una determinata colonna. Se viene trovato, il CanRemove metodo verifica se la colonna può essere rimossa. In tal caso, la colonna viene rimossa con il Remove metodo .

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

Commenti

Se la raccolta viene modificata correttamente aggiungendo o rimuovendo colonne, si verifica l'evento CollectionChanged .

Vedi anche

• Contains(String)