DataTable.HasErrors Propriedade

Definição

Espaço de Nomes:
System.Data
Assemblagem:
System.Data.dll
Assemblagem:
netstandard.dll

Obtém um valor que indica se existem erros em alguma das linhas de alguma das tabelas a DataSet que a tabela pertence.

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

Valor de Propriedade

Boolean

true se existirem erros; caso contrário false.

Atributos
BrowsableAttribute DataSysDescriptionAttribute

Exemplos

O exemplo seguinte usa a HasErrors propriedade para verificar se uma tabela contém erros.

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

Observações

À medida que os utilizadores trabalham num conjunto de dados contidos num DataTable, pode marcar cada alteração com um erro se a alteração causar alguma falha de validação. Pode marcar um total DataRow com uma mensagem de erro usando a RowError propriedade. Também podes definir erros em cada coluna da linha com o SetColumnError método.

Antes de atualizar uma fonte de dados com um DataSet, recomenda-se que primeiro invoque o GetChanges método no alvo DataSet. O método resulta num DataSet que contém apenas as alterações feitas ao original. Antes de o enviar DataSet para a fonte de dados para atualização, verifique a HasErrors propriedade de cada tabela para verificar se foram associados erros às linhas ou colunas das linhas.

Após reconciliar cada erro, limpe-os com o ClearErrors método do DataRow.

Aplica-se a

Ver também