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);
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

エラーの説明を設定する対象となる DataColumnThe 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または空の文字列がパラメーターとして渡された場合 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.

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

列の 0 から始まるインデックス番号。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または空の文字列がパラメーターとして渡された場合 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.

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);
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または空の文字列がパラメーターとして渡された場合 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.

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.

こちらもご覧ください

適用対象