DataRow.SetColumnError Method

Definition

Define uma descrição de erro de uma coluna.Sets the error description for a column.

Overloads

SetColumnError(DataColumn, String)

Define a descrição do erro para uma coluna especificada como um DataColumn.Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String)

Define a descrição do erro da coluna especificada pelo índice.Sets the error description for a column specified by index.

SetColumnError(String, String)

Define a descrição do erro da coluna especificada pelo nome.Sets the error description for a column specified by name.

SetColumnError(DataColumn, String)

Define a descrição do erro para uma coluna especificada como um DataColumn.Sets the error description for a column specified as a 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)

Parameters

column
DataColumn

O DataColumn para o qual definir a descrição do erro.The DataColumn to set the error description for.

error
String

A descrição do erro.The error description.

Examples

O exemplo a seguir define uma descrição de erro para um DataRow especificado.The following example sets an error description for a specified DataRow.

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

Remarks

Para examinar as descrições de erro, use o método GetColumnError.To examine error descriptions, use the GetColumnError method.

Para determinar se existem erros para a coleção de colunas, use a propriedade HasErrors.To determine whether any errors exist for the columns collection, use the HasErrors property. Consequentemente, é possível usar o método GetColumnsInError para recuperar todas as colunas com erros.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Se null ou uma cadeia de caracteres vazia for transmitida como o parâmetro error, o DataRow se comporta como se nenhum erro fosse definido e a propriedade HasErrors retornará false.If null or an empty string is passed in as the error parameter, the DataRow behaves as if no error was set and the HasErrors property will return false.

Para definir uma descrição de erro personalizada na linha inteira, use a propriedade RowError.To set a custom error description on the whole row, use the RowError property.

Para determinar se existe algum erro para a coleção de colunas, use o método HasErrors.To determine whether any errors exist for the columns collection, use the HasErrors method.

Para limpar todos os erros da coleção de colunas, use o método ClearErrors.To clear all errors for the columns collection, use the ClearErrors method.

See also

SetColumnError(Int32, String)

Define a descrição do erro da coluna especificada pelo índice.Sets the error description for a column specified by index.

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)

Parameters

columnIndex
Int32

O índice com base em zero da coluna.The zero-based index of the column.

error
String

A descrição do erro.The error description.

Exceptions

O argumento columnIndex está fora do intervaloThe columnIndex argument is out of range

Examples

O exemplo a seguir define uma descrição de erro para um DataRow especificado.The following example sets an error description for a specified DataRow.

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

Remarks

O método é usado para definir descrições de erro personalizadas em colunas especificadas.The method is used to set custom error descriptions on specified columns. Você pode usar o controle de ErrorProvider para exibir o texto do erro.You can use the ErrorProvider control to display the text of the error.

Para examinar as descrições de erro, use o método GetColumnError.To examine error descriptions, use the GetColumnError method.

Para determinar se existem erros para a coleção de colunas, use a propriedade HasErrors.To determine whether any errors exist for the columns collection, use the HasErrors property. Consequentemente, é possível usar o método GetColumnsInError para recuperar todas as colunas com erros.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Se null ou uma cadeia de caracteres vazia for transmitida como o parâmetro error, o DataRow se comporta como se nenhum erro fosse definido e a propriedade HasErrors retornará false.If null or an empty string is passed in as the error parameter, the DataRow behaves as if no error was set and the HasErrors property will return false.

Para definir uma descrição de erro personalizada na linha inteira, use a propriedade RowError.To set a custom error description on the whole row, use the RowError property.

Para limpar todos os erros da coleção de colunas, use o método ClearErrors.To clear all errors for the columns collection, use the ClearErrors method.

Para definir o texto de erro que se aplica a uma linha inteira, defina a propriedade RowError.To set error text that applies to a whole row, set the RowError property.

See also

SetColumnError(String, String)

Define a descrição do erro da coluna especificada pelo nome.Sets the error description for a column specified by name.

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)

Parameters

columnName
String

O nome da coluna.The name of the column.

error
String

A descrição do erro.The error description.

Examples

O exemplo a seguir define uma descrição de erro para um DataRow especificado.The following example sets an error description for a specified DataRow.

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

Remarks

O nome de uma coluna é definido com a propriedade ColumnName da classe DataColumn.The name of a column is set with the ColumnName property of the DataColumn class.

Para examinar as descrições de erro, use o método GetColumnError.To examine error descriptions, use the GetColumnError method.

Para determinar se existem erros para a coleção de colunas, use a propriedade HasErrors.To determine whether any errors exist for the columns collection, use the HasErrors property. Consequentemente, é possível usar o método GetColumnsInError para recuperar todas as colunas com erros.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Se null ou uma cadeia de caracteres vazia for transmitida como o parâmetro error, o DataRow se comporta como se nenhum erro fosse definido e a propriedade HasErrors retornará false.If null or an empty string is passed in as the error parameter, the DataRow behaves as if no error was set and the HasErrors property will return false.

Para definir uma descrição de erro personalizada na linha inteira, use a propriedade RowError.To set a custom error description on the whole row, use the RowError property.

Para determinar se existe algum erro para a coleção de colunas, use o método HasErrors.To determine whether any errors exist for the columns collection, use the HasErrors method.

Para limpar todos os erros da coleção de colunas, use o método ClearErrors.To clear all errors for the columns collection, use the ClearErrors method.

See also

Applies to