DataRowCollection.Remove(DataRow) Method

Definition

Remove o DataRow especificado da coleção.Removes the specified DataRow from the collection.

public:
 void Remove(System::Data::DataRow ^ row);
public void Remove (System.Data.DataRow row);
member this.Remove : System.Data.DataRow -> unit
Public Sub Remove (row As DataRow)

Parameters

row
DataRow

O DataRow a ser removido.The DataRow to remove.

Examples

O exemplo a seguir usa o método Remove para excluir uma linha encontrada em um objeto DataRowCollection.The following example uses the Remove method to delete a found row in a DataRowCollection object. O exemplo primeiro usa o método Contains para determinar se a coleção Rows contém uma linha.The example first uses the Contains method to determine whether the rows collection contains a row. Se tiver, o método Find será usado para localizar a linha específica e o método Remove será usado para remover a linha.If it does, the Find method is used to find the specific row, and the Remove method is then used to remove the row.

Private Sub RemoveFoundRow(ByVal table As DataTable)
    Dim rowCollection As DataRowCollection = table.Rows

    ' Test to see if the collection contains the value.
    If rowCollection.Contains(TextBox1.Text) Then
        Dim foundRow As DataRow = rowCollection.Find(TextBox1.Text)
        rowCollection.Remove(foundRow)
        Console.WriteLine("Row Deleted")
    Else
        Console.WriteLine("No such row found.")
    End If
 End Sub

Remarks

Quando uma linha é removida, todos os dados nessa linha são perdidos.When a row is removed, all data in that row is lost. Você também pode chamar o método Delete da classe DataRow para apenas marcar uma linha para remoção.You can also call the Delete method of the DataRow class to just mark a row for removal. Chamar Remove é o mesmo que chamar Delete e, em seguida, chamar AcceptChanges.Calling Remove is the same as calling Delete and then calling AcceptChanges.

Remove não deve ser chamado em um loop foreach durante a iteração por meio de um objeto DataRowCollection.Remove should not be called in a foreach loop while iterating through a DataRowCollection object. Remove modifica o estado da coleção.Remove modifies the state of the collection.

Você também pode usar o método Clear para remover todos os membros da coleção de uma só vez.You can also use the Clear method to remove all members of the collection at one time.

Applies to

See also