DataRow.SetColumnError 方法

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

为列设置错误说明。

重载

SetColumnError(DataColumn, String)	为指定为 DataColumn 的列设置错误说明。
SetColumnError(Int32, String)	为由索引指定的列设置错误说明。
SetColumnError(String, String)	为由名称指定的列设置错误说明。

SetColumnError(DataColumn, String)

Source:

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)

Source:

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)

Source:

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

注解

使用 类的 属性DataColumn设置ColumnName列的名称。

若要检查错误说明，请使用 GetColumnError 方法。

若要确定列集合是否存在任何错误，请使用 HasErrors 属性。 因此，可以使用 GetColumnsInError 方法检索具有错误的所有列。

如果 null 或 空字符串作为 error 参数传入， DataRow 的行为就像未设置错误一样， HasErrors 属性将返回 false。

若要对整个行设置自定义错误说明，请使用 RowError 属性。

若要确定列集合是否存在任何错误，请使用 HasErrors 方法。

若要清除列集合的所有错误，请使用 ClearErrors 方法。

另请参阅

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