DataRow.SetColumnError DataRow.SetColumnError DataRow.SetColumnError DataRow.SetColumnError Method

定義

列のエラーの説明を設定します。Sets the error description for a column.

オーバーロード

SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String)

DataColumn として指定した列のエラーの説明を設定します。Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String)

インデックスで指定した列のエラーの説明を設定します。Sets the error description for a column specified by index.

SetColumnError(String, String) SetColumnError(String, String) SetColumnError(String, String) SetColumnError(String, String)

名前で指定した列のエラーの説明を設定します。Sets the error description for a column specified by name.

SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) SetColumnError(DataColumn, String) 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 DataColumn DataColumn

エラーの説明を設定する対象となる DataColumnThe DataColumn to set the error description for.

error
String String String 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.

列コレクションにエラーがあるかどうかを調べるには、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または空の文字列として渡される、errorパラメーター、DataRowエラーが設定されていない場合と同様に、HasErrorsプロパティは false を返します。If 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.

列コレクションにエラーがあるかどうかを調べるには、HasErrorsメソッド。To determine whether any errors exist for the columns collection, use the HasErrors method.

列コレクションのすべてのエラーをクリアするには、使用、ClearErrorsメソッド。To clear all errors for the columns collection, use the ClearErrors method.

こちらもご覧ください

SetColumnError(Int32, String) SetColumnError(Int32, String) SetColumnError(Int32, String) 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 Int32 Int32 Int32

列の 0 から始まるインデックス番号。The zero-based index of the column.

error
String String String 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.

列コレクションにエラーがあるかどうかを調べるには、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または空の文字列として渡される、errorパラメーター、DataRowエラーが設定されていない場合と同様に、HasErrorsプロパティは false を返します。If 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.

列コレクションのすべてのエラーをクリアするには、使用、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) SetColumnError(String, String) SetColumnError(String, String) 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 String String String

列の名前。The name of the column.

error
String String String 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.

列コレクションにエラーがあるかどうかを調べるには、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または空の文字列として渡される、errorパラメーター、DataRowエラーが設定されていない場合と同様に、HasErrorsプロパティは false を返します。If 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.

列コレクションにエラーがあるかどうかを調べるには、HasErrorsメソッド。To determine whether any errors exist for the columns collection, use the HasErrors method.

列コレクションのすべてのエラーをクリアするには、使用、ClearErrorsメソッド。To clear all errors for the columns collection, use the ClearErrors method.

こちらもご覧ください

適用対象