DataRow.SetColumnError Метод

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Задает описание ошибки для столбца.

Перегрузки

SetColumnError(DataColumn, String)	Задает описание ошибки для столбца, указанного как DataColumn.
SetColumnError(Int32, String)	Задает описание ошибки для столбца, указанного по индексу.
SetColumnError(String, String)	Задает описание ошибки для столбца, указанного по имени.

SetColumnError(DataColumn, String)

Исходный код:

DataRow.cs

Задает описание ошибки для столбца, указанного как 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)

Параметры

column

DataColumn

Объект DataColumn, для которого задается описание ошибки.

error

String

Описание ошибки.

Примеры

В следующем примере задается описание ошибки для указанного 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

Комментарии

Чтобы изучить описания ошибок, используйте GetColumnError метод .

Чтобы определить, существуют ли ошибки для коллекции столбцов, используйте HasErrors свойство . Следовательно, можно использовать метод для GetColumnsInError получения всех столбцов с ошибками.

Если null или пустая строка передается в качестве error параметра, объект ведет себя так, DataRow как если бы ошибка не была задана HasErrors , и свойство возвращает значение false.

Чтобы задать пользовательское описание ошибки для всей строки, используйте RowError свойство .

Чтобы определить, существуют ли ошибки для коллекции столбцов, используйте HasErrors метод .

Чтобы удалить все ошибки для коллекции столбцов, используйте ClearErrors метод .

См. также раздел

• ClearErrors()
• DataColumnCollection
• Contains(String)
• DataColumn
• GetColumnsInError()
• HasErrors
• RowError

SetColumnError(Int32, String)

Исходный код:

DataRow.cs

Задает описание ошибки для столбца, указанного по индексу.

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)

Параметры

columnIndex

Int32

Индекс столбца (с нуля).

error

String

Описание ошибки.

Исключения

IndexOutOfRangeException

Аргумент columnIndex вне диапазона

Примеры

В следующем примере задается описание ошибки для указанного 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

Комментарии

Метод используется для задания пользовательских описаний ошибок в указанных столбцах. Для отображения текста ошибки можно использовать ErrorProvider элемент управления .

Чтобы изучить описания ошибок, используйте GetColumnError метод .

Чтобы определить, существуют ли ошибки для коллекции столбцов, используйте HasErrors свойство . Следовательно, можно использовать метод для GetColumnsInError получения всех столбцов с ошибками.

Если null или пустая строка передается в качестве error параметра, объект ведет себя так, DataRow как если бы ошибка не была задана HasErrors , и свойство возвращает значение false.

Чтобы задать пользовательское описание ошибки для всей строки, используйте RowError свойство .

Чтобы удалить все ошибки для коллекции столбцов, используйте ClearErrors метод .

Чтобы задать текст ошибки, применимый ко всей строке RowError , задайте свойство .

См. также раздел

• ClearErrors()
• DataColumnCollection
• Contains(String)
• DataColumn
• GetColumnsInError()
• HasErrors
• RowError

SetColumnError(String, String)

Исходный код:

DataRow.cs

Задает описание ошибки для столбца, указанного по имени.

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)

Параметры

columnName

String

Имя столбца.

error

String

Описание ошибки.

Примеры

В следующем примере задается описание ошибки для указанного 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

Комментарии

Имя столбца задается свойством ColumnNameDataColumn класса .

Чтобы изучить описания ошибок, используйте GetColumnError метод .

Чтобы определить, существуют ли ошибки для коллекции столбцов, используйте HasErrors свойство . Следовательно, можно использовать метод для GetColumnsInError получения всех столбцов с ошибками.

Если null или пустая строка передается в качестве error параметра, объект ведет себя так, DataRow как если бы ошибка не была задана HasErrors , и свойство возвращает значение false.

Чтобы задать пользовательское описание ошибки для всей строки, используйте RowError свойство .

Чтобы определить, существуют ли ошибки для коллекции столбцов, используйте HasErrors метод .

Чтобы удалить все ошибки для коллекции столбцов, используйте ClearErrors метод .

См. также раздел

• ClearErrors()
• DataColumnCollection
• Contains(String)
• DataColumn
• GetColumnsInError()
• HasErrors
• RowError