DataRow.SetColumnError Метод

Определение

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

System.Data

Сборка:

System.Data.Common.dll

Сборка:

System.Data.dll

Сборка:

netstandard.dll

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

Перегрузки

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

SetColumnError(DataColumn, String)

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

Параметры

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)

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

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)

Параметры

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)

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

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)

Параметры

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

Комментарии

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

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

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

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

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

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

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

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

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