DataRow.SetColumnError Método

Definição

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

Sobrecargas

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)

Parâmetros

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.

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, GetColumnError use o método.To examine error descriptions, use the GetColumnError method.

Para determinar se existem erros para a coleção de colunas, use a 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 for passada como error o parâmetro, DataRow o se comformará como se nenhum erro fosse definido HasErrors e a 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 personalizada na linha inteira, use a 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)

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

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.

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 descrições de erro personalizadas em 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, GetColumnError use o método.To examine error descriptions, use the GetColumnError method.

Para determinar se existem erros para a coleção de colunas, use a 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 for passada como error o parâmetro, DataRow o se comformará como se nenhum erro fosse definido HasErrors e a 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 personalizada na linha inteira, use a 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 RowError , defina a propriedade.To set error text that applies to a whole row, set the RowError property.

Veja também

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

O nome da coluna.The name of the column.

error
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 a ColumnName propriedade DataColumn da classe.The name of a column is set with the ColumnName property of the DataColumn class.

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

Para determinar se existem erros para a coleção de colunas, use a 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 for passada como error o parâmetro, DataRow o se comformará como se nenhum erro fosse definido HasErrors e a 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 personalizada na linha inteira, use a 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