DataRow.SetColumnError Метод

Определение

Задает описание ошибки для столбца.Sets the error description for a column.

Перегрузки

SetColumnError(DataColumn, String)

Задает описание ошибки для столбца, указанного как DataColumn.Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String)

Задает описание ошибки для столбца, указанного по индексу.Sets the error description for a column specified by index.

SetColumnError(String, String)

Задает описание ошибки для столбца, указанного по имени.Sets the error description for a column specified by name.

SetColumnError(DataColumn, String)

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

Параметры

column
DataColumn

Объект DataColumn, для которого задается описание ошибки.The DataColumn to set the error description for.

error
String

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

Примеры

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

Комментарии

Чтобы просмотреть описания ошибок, используйте GetColumnError метод.To examine error descriptions, use the GetColumnError method.

Чтобы определить, существуют ли какие либо ошибки для коллекции Columns, HasErrors используйте свойство.To determine whether any errors exist for the columns collection, use the HasErrors property. Следовательно, можно использовать GetColumnsInError метод для получения всех столбцов с ошибками.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Если null в DataRow HasErrors качестве параметра передается пустая строка, то она ведет себя так, как если бы ошибки не было задано, а свойство возвращает значение false. errorIf 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.

Чтобы задать пользовательское описание ошибки для всей строки, используйте RowError свойство.To set a custom error description on the whole row, use the RowError property.

Чтобы определить, существуют ли какие либо ошибки для коллекции Columns, HasErrors используйте метод.To determine whether any errors exist for the columns collection, use the HasErrors method.

Чтобы очистить все ошибки для коллекции Columns, используйте ClearErrors метод.To clear all errors for the columns collection, use the ClearErrors method.

Дополнительно

SetColumnError(Int32, String)

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

Параметры

columnIndex
Int32

Индекс столбца (с нуля).The zero-based index of the column.

error
String

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

Исключения

Аргумент columnIndex вне диапазонаThe columnIndex argument is out of range

Примеры

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

Комментарии

Метод используется для задания пользовательских описаний ошибок для указанных столбцов.The method is used to set custom error descriptions on specified columns. Для вывода текста ошибки ErrorProvider можно использовать элемент управления.You can use the ErrorProvider control to display the text of the error.

Чтобы просмотреть описания ошибок, используйте GetColumnError метод.To examine error descriptions, use the GetColumnError method.

Чтобы определить, существуют ли какие либо ошибки для коллекции Columns, HasErrors используйте свойство.To determine whether any errors exist for the columns collection, use the HasErrors property. Следовательно, можно использовать GetColumnsInError метод для получения всех столбцов с ошибками.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Если null в DataRow HasErrors качестве параметра передается пустая строка, то она ведет себя так, как если бы ошибки не было задано, а свойство возвращает значение false. errorIf 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.

Чтобы задать пользовательское описание ошибки для всей строки, используйте RowError свойство.To set a custom error description on the whole row, use the RowError property.

Чтобы очистить все ошибки для коллекции Columns, используйте ClearErrors метод.To clear all errors for the columns collection, use the ClearErrors method.

Чтобы задать текст ошибки, который применяется ко всей строке, задайте RowError свойство.To set error text that applies to a whole row, set the RowError property.

Дополнительно

SetColumnError(String, String)

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

Параметры

columnName
String

Имя столбца.The name of the column.

error
String

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

Примеры

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

Комментарии

Имя столбца задается ColumnName свойством DataColumn класса.The name of a column is set with the ColumnName property of the DataColumn class.

Чтобы просмотреть описания ошибок, используйте GetColumnError метод.To examine error descriptions, use the GetColumnError method.

Чтобы определить, существуют ли какие либо ошибки для коллекции Columns, HasErrors используйте свойство.To determine whether any errors exist for the columns collection, use the HasErrors property. Следовательно, можно использовать GetColumnsInError метод для получения всех столбцов с ошибками.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Если null в DataRow HasErrors качестве параметра передается пустая строка, то она ведет себя так, как если бы ошибки не было задано, а свойство возвращает значение false. errorIf 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.

Чтобы задать пользовательское описание ошибки для всей строки, используйте RowError свойство.To set a custom error description on the whole row, use the RowError property.

Чтобы определить, существуют ли какие либо ошибки для коллекции Columns, HasErrors используйте метод.To determine whether any errors exist for the columns collection, use the HasErrors method.

Чтобы очистить все ошибки для коллекции Columns, используйте ClearErrors метод.To clear all errors for the columns collection, use the ClearErrors method.

Дополнительно

Применяется к