Ler em inglês

Compartilhar via


DataRow.SetColumnError Método

Definição

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
Origem:
DataRow.cs
Origem:
DataRow.cs

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

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

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));
}

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

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

SetColumnError(Int32, String)

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

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

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

Parâmetros

columnIndex
Int32

O índice com base em zero da coluna.

error
String

A descrição do erro.

Exceções

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));
}

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

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

SetColumnError(String, String)

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

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

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

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));
}

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

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1