DataTable.HasErrors Propriedade

Definição

Obtém um valor que indica se há erros em alguma das linhas em uma das tabelas de DataSet a que a tabela pertence.Gets a value indicating whether there are errors in any of the rows in any of the tables of the DataSet to which the table belongs.

public:
 property bool HasErrors { bool get(); };
public bool HasErrors { get; }
[System.ComponentModel.Browsable(false)]
public bool HasErrors { get; }
[System.ComponentModel.Browsable(false)]
[System.Data.DataSysDescription("DataTableHasErrorsDescr")]
public bool HasErrors { get; }
member this.HasErrors : bool
Public ReadOnly Property HasErrors As Boolean

Valor da propriedade

true se houver erros; caso contrário, false.true if errors exist; otherwise false.

Atributos

Exemplos

O exemplo a seguir usa a propriedade HasErrors para verificar se uma tabela contém erros.The following example uses the HasErrors property to check if a table contains errors.

private void CheckForErrors(DataSet dataSet) 
{
    // Invoke GetChanges on the DataSet to create a reduced set.
    DataSet thisDataSet = dataSet.GetChanges();

    // Check each table's HasErrors property.
    foreach(DataTable table in thisDataSet.Tables) 
    {
        // If HasErrors is true, reconcile errors.
        if(table.HasErrors) 
        {
            // Insert code to reconcile errors.
        }
    }
}
Private Sub CheckForErrors(dataSet As DataSet)
    ' Invoke GetChanges on the DataSet to create a reduced set.
    Dim thisDataSet As DataSet = dataSet.GetChanges()

    ' Check each table's HasErrors property.
    Dim table As DataTable
    For Each table In thisDataSet.Tables
        ' If HasErrors is true, reconcile errors.
        If table.HasErrors Then
            ' Insert code to reconcile errors.
        End If
    Next table
End Sub

Comentários

Como os usuários trabalham em um conjunto de dados contidos em um DataTable, você pode marcar cada alteração com um erro se a alteração causar alguma falha de validação.As users work on a set of data contained in a DataTable, you can mark each change with an error if the change causes some validation failure. Você pode marcar um DataRow inteiro com uma mensagem de erro usando a propriedade RowError.You can mark an entire DataRow with an error message using the RowError property. Você também pode definir erros em cada coluna da linha com o método SetColumnError.You can also set errors on each column of the row with the SetColumnError method.

Antes de atualizar uma fonte de dados com um DataSet, é recomendável que você primeiro invoque o método GetChanges no DataSetde destino.Before updating a data source with a DataSet, it's recommended that you first invoke the GetChanges method on the target DataSet. O método resulta em um DataSet que contém apenas as alterações feitas no original.The method results in a DataSet that contains only the changes made to the original. Antes de enviar o DataSet à fonte de dados para atualização, verifique a propriedade HasErrors de cada tabela para ver se algum erro foi anexado às linhas ou colunas nas linhas.Before sending the DataSet to the data source for updating, check the HasErrors property of each table to see if any errors have been attached to the rows or columns in the rows.

Depois de reconciliar cada erro, desmarque os erros com o método ClearErrors do DataRow.After reconciling each error, clear the errors with the ClearErrors method of the DataRow.

Aplica-se a

Veja também