DataRow.SetColumnError Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает описание ошибки для столбца.
Перегрузки
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
Описание ошибки.
Исключения
Аргумент 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