DataRow.SetColumnError Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Define uma descrição de erro de uma coluna.

Sobrecargas

SetColumnError(DataColumn, String)	Define a descrição do erro para uma coluna especificada como um DataColumn.
SetColumnError(Int32, String)	Define a descrição do erro da coluna especificada pelo índice.
SetColumnError(String, String)	Define a descrição do erro da coluna especificada pelo nome.

SetColumnError(DataColumn, String)

Origem:

DataRow.cs

Define a descrição do erro para uma coluna especificada como um DataColumn.

public:
 void SetColumnError(System::Data::DataColumn ^ column, System::String ^ error);

public void SetColumnError (System.Data.DataColumn column, string? error);

member this.SetColumnError : System.Data.DataColumn * string -> unit

Public Sub SetColumnError (column As DataColumn, error As String)

Parâmetros

column

DataColumn

O DataColumn para o qual definir a descrição do erro.

error

String

A descrição do erro.

Exemplos

O exemplo a seguir define uma descrição de erro para um DataRow especificado.

private void SetColError(DataRow row, int columnIndex)
{
    string errorString = "Replace this text.";

    // Set the error for the specified column of the row.
    row.SetColumnError(columnIndex, errorString);
}

private void PrintColError(DataRow row, int columnIndex)
{
    // Print the error of a specified column.
    Console.WriteLine(row.GetColumnError(columnIndex));
}

Private Sub SetColError(ByVal row As DataRow, _
    byVal columnIndex As Integer)
    Dim errorString As String = "Replace this text."

    ' Set the error for the specified column of the row.
    row.SetColumnError(columnIndex, errorString)
End Sub
 
Private Sub PrintColError( _
    ByVal row As DataRow, byVal columnIndex As Integer)

    ' Print the error of a specified column.
    Console.WriteLine(row.GetColumnError(columnIndex))
End Sub

Comentários

Para examinar descrições de erro, use o GetColumnError método .

Para determinar se existem erros para a coleção de colunas, use a HasErrors propriedade . Consequentemente, é possível usar o método GetColumnsInError para recuperar todas as colunas com erros.

Se null ou uma cadeia de caracteres vazia for passada como o error parâmetro , o DataRow se comportará como se nenhum erro tivesse sido definido e a HasErrors propriedade retornaria false.

Para definir uma descrição de erro personalizada em toda a linha, use a RowError propriedade .

Para determinar se existe algum erro para a coleção de colunas, use o método HasErrors.

Para limpar todos os erros da coleção de colunas, use o método ClearErrors.

Confira também

• ClearErrors()
• DataColumnCollection
• Contains(String)
• DataColumn
• GetColumnsInError()
• HasErrors
• RowError

SetColumnError(Int32, String)

Origem:

DataRow.cs

Define a descrição do erro da coluna especificada pelo índice.

public:
 void SetColumnError(int columnIndex, System::String ^ error);

public void SetColumnError (int columnIndex, string? error);

member this.SetColumnError : int * string -> unit

Public Sub SetColumnError (columnIndex As Integer, error As String)

Parâmetros

columnIndex

Int32

O índice com base em zero da coluna.

error

String

A descrição do erro.

Exceções

IndexOutOfRangeException

O argumento columnIndex está fora do intervalo

Exemplos

O exemplo a seguir define uma descrição de erro para um DataRow especificado.

private void SetColError(DataRow row, int columnIndex)
{
    string errorString = "Replace this text.";

    // Set the error for the specified column of the row.
    row.SetColumnError(columnIndex, errorString);
}

private void PrintColError(DataRow row, int columnIndex)
{
    // Print the error of a specified column.
    Console.WriteLine(row.GetColumnError(columnIndex));
}

Private Sub SetColError(ByVal row As DataRow, _
    byVal columnIndex As Integer)
    Dim errorString As String = "Replace this text."

    ' Set the error for the specified column of the row.
    row.SetColumnError(columnIndex, errorString)
End Sub
 
Private Sub PrintColError( _
    ByVal row As DataRow, byVal columnIndex As Integer)

    ' Print the error of a specified column.
    Console.WriteLine(row.GetColumnError(columnIndex))
End Sub

Comentários

O método é usado para definir descrições de erro personalizadas em colunas especificadas. Você pode usar o ErrorProvider controle para exibir o texto do erro.

Para examinar descrições de erro, use o GetColumnError método .

Para determinar se existem erros para a coleção de colunas, use a HasErrors propriedade . Consequentemente, é possível usar o método GetColumnsInError para recuperar todas as colunas com erros.

Se null ou uma cadeia de caracteres vazia for passada como o error parâmetro , o DataRow se comportará como se nenhum erro tivesse sido definido e a HasErrors propriedade retornaria false.

Para definir uma descrição de erro personalizada em toda a linha, use a RowError propriedade .

Para limpar todos os erros da coleção de colunas, use o método ClearErrors.

Para definir o texto de erro que se aplica a uma linha inteira, defina a RowError propriedade .

Confira também

• ClearErrors()
• DataColumnCollection
• Contains(String)
• DataColumn
• GetColumnsInError()
• HasErrors
• RowError

SetColumnError(String, String)

Origem:

DataRow.cs

Define a descrição do erro da coluna especificada pelo nome.

public:
 void SetColumnError(System::String ^ columnName, System::String ^ error);

public void SetColumnError (string columnName, string? error);

member this.SetColumnError : string * string -> unit

Public Sub SetColumnError (columnName As String, error As String)

Parâmetros

columnName

String

O nome da coluna.

error

String

A descrição do erro.

Exemplos

O exemplo a seguir define uma descrição de erro para um DataRow especificado.

private void SetColError(DataRow row, int columnIndex)
{
    string errorString = "Replace this text.";

    // Set the error for the specified column of the row.
    row.SetColumnError(columnIndex, errorString);
}

private void PrintColError(DataRow row, int columnIndex)
{
    // Print the error of a specified column.
    Console.WriteLine(row.GetColumnError(columnIndex));
}

Private Sub SetColError(ByVal row As DataRow, _
    byVal columnIndex As Integer)
    Dim errorString As String = "Replace this text."

    ' Set the error for the specified column of the row.
    row.SetColumnError(columnIndex, errorString)
End Sub
 
Private Sub PrintColError( _
    ByVal row As DataRow, byVal columnIndex As Integer)

    ' Print the error of a specified column.
    Console.WriteLine(row.GetColumnError(columnIndex))
End Sub

Comentários

O nome de uma coluna é definido com a ColumnName propriedade da DataColumn classe .

Para examinar descrições de erro, use o GetColumnError método .

Para determinar se existem erros para a coleção de colunas, use a HasErrors propriedade . Consequentemente, é possível usar o método GetColumnsInError para recuperar todas as colunas com erros.

Se null ou uma cadeia de caracteres vazia for passada como o error parâmetro , o DataRow se comportará como se nenhum erro tivesse sido definido e a HasErrors propriedade retornaria false.

Para definir uma descrição de erro personalizada em toda a linha, use a RowError propriedade .

Para determinar se existe algum erro para a coleção de colunas, use o método HasErrors.

Para limpar todos os erros da coleção de colunas, use o método ClearErrors.

Confira também

• ClearErrors()
• DataColumnCollection
• Contains(String)
• DataColumn
• GetColumnsInError()
• HasErrors
• RowError