DataRow.SetColumnError DataRow.SetColumnError DataRow.SetColumnError DataRow.SetColumnError Method

Definição

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

Sobrecargas

SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) 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) SetColumnError(Int32, String) SetColumnError(Int32, String) 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) SetColumnError(String, String) SetColumnError(String, String) 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) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) 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)

Parâmetros

column
DataColumn DataColumn DataColumn DataColumn

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

error
String String String String

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

Exemplos

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

Comentários

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

Para determinar se existe algum erro para a coleção de colunas, use o HasErrors propriedade.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 é passada como o error parâmetro, o DataRow se comporta como se nenhum erro foi definido e o HasErrors propriedade 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 personalizadas em toda a linha, use o RowError propriedade.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.

Veja também

SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String) 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)

Parâmetros

columnIndex
Int32 Int32 Int32 Int32

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

error
String String String String

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

Exceções

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

Exemplos

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

Comentários

O método é usado para definir as descrições de erro personalizada nas colunas especificadas.The method is used to set custom error descriptions on specified columns. Você pode usar o ErrorProvider controle 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 GetColumnError método.To examine error descriptions, use the GetColumnError method.

Para determinar se existe algum erro para a coleção de colunas, use o HasErrors propriedade.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 é passada como o error parâmetro, o DataRow se comporta como se nenhum erro foi definido e o HasErrors propriedade 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 personalizadas em toda a linha, use o RowError propriedade.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 o RowError propriedade.To set error text that applies to a whole row, set the RowError property.

Veja também

SetColumnError(String, String) SetColumnError(String, String) SetColumnError(String, String) 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)

Parâmetros

columnName
String String String String

O nome da coluna.The name of the column.

error
String String String String

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

Exemplos

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

Comentários

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

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

Para determinar se existe algum erro para a coleção de colunas, use o HasErrors propriedade.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 é passada como o error parâmetro, o DataRow se comporta como se nenhum erro foi definido e o HasErrors propriedade 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 personalizadas em toda a linha, use o RowError propriedade.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.

Veja também

Aplica-se a