Compartilhar via

DataRow.SetColumnError Método

Definição

Namespace:
System.Data
Assemblies:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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

Sobrecargas

Nome Description
SetColumnError(DataColumn, String)

Define a descrição do erro de uma coluna especificada como um DataColumn.
SetColumnError(Int32, String)

Define a descrição do erro de uma coluna especificada pelo índice.
SetColumnError(String, String)

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

SetColumnError(DataColumn, String)

Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs

Define a descrição do erro de 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);
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

Para DataColumn 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 especificado 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 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, você pode usar o GetColumnsInError método para recuperar todas as colunas com erros.

Se null ou uma cadeia de caracteres vazia for passada como o error parâmetro, ela 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 existem erros para a coleção de colunas, use o HasErrors método.

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

Confira também

Aplica-se a

SetColumnError(Int32, String)

Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs

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

public:
 void SetColumnError(int columnIndex, System::String ^ error);
public void SetColumnError(int columnIndex, 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 baseado em zero da coluna.

error
String

A descrição do erro.

Exceções

IndexOutOfRangeException

O columnIndex argumento está fora do intervalo

Exemplos

O exemplo a seguir define uma descrição de erro para um especificado 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. 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, você pode usar o GetColumnsInError método para recuperar todas as colunas com erros.

Se null ou uma cadeia de caracteres vazia for passada como o error parâmetro, ela 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 ClearErrors método.

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

Confira também

Aplica-se a

SetColumnError(String, String)

Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs
Origem:
DataRow.cs

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

public:
 void SetColumnError(System::String ^ columnName, System::String ^ error);
public void SetColumnError(string columnName, 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 especificado 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 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, você pode usar o GetColumnsInError método para recuperar todas as colunas com erros.

Se null ou uma cadeia de caracteres vazia for passada como o error parâmetro, ela 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 existem erros para a coleção de colunas, use o HasErrors método.

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

Confira também

Aplica-se a