DataRow.SetColumnError Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Legt die Fehlerbeschreibung für eine Spalte fest.

Überlädt

SetColumnError(DataColumn, String)	Legt die Fehlerbeschreibung für eine als DataColumn angegebene Spalte fest.
SetColumnError(Int32, String)	Legt die Fehlerbeschreibung für eine durch den Index angegebene Spalte fest.
SetColumnError(String, String)	Legt die Fehlerbeschreibung für eine durch den Namen angegebene Spalte fest.

SetColumnError(DataColumn, String)

Quelle:

DataRow.cs

Legt die Fehlerbeschreibung für eine als DataColumn angegebene Spalte fest.

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)

Parameter

column

DataColumn

Die DataColumn, für die die Fehlerbeschreibung festgelegt werden soll.

error

String

Die Fehlerbeschreibung.

Beispiele

Im folgenden Beispiel wird eine Fehlerbeschreibung für eine angegebene DataRowfestgelegt.

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

Hinweise

Verwenden Sie die GetColumnError -Methode, um Fehlerbeschreibungen zu untersuchen.

Verwenden Sie die -Eigenschaft, um zu bestimmen, ob Fehler für die HasErrors Spaltenauflistung vorhanden sind. Folglich können Sie die GetColumnsInError -Methode verwenden, um alle Spalten mit Fehlern abzurufen.

Wenn null oder eine leere Zeichenfolge als error Parameter übergeben wird, verhält sich das DataRow so, als ob kein Fehler festgelegt wurde, und die HasErrors Eigenschaft gibt false zurück.

Verwenden Sie die -Eigenschaft, um eine benutzerdefinierte Fehlerbeschreibung für die RowError gesamte Zeile festzulegen.

Verwenden Sie die HasErrors -Methode, um zu bestimmen, ob Fehler für die Spaltenauflistung vorhanden sind.

Verwenden Sie die ClearErrors -Methode, um alle Fehler für die Spaltenauflistung zu löschen.

Weitere Informationen

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

SetColumnError(Int32, String)

Quelle:

DataRow.cs

Legt die Fehlerbeschreibung für eine durch den Index angegebene Spalte fest.

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)

Parameter

columnIndex

Int32

Der nullbasierte Index der Spalte.

error

String

Die Fehlerbeschreibung.

Ausnahmen

IndexOutOfRangeException

Das columnIndex-Argument liegt außerhalb des gültigen Bereichs.

Beispiele

Im folgenden Beispiel wird eine Fehlerbeschreibung für eine angegebene DataRowfestgelegt.

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

Hinweise

Die -Methode wird verwendet, um benutzerdefinierte Fehlerbeschreibungen für angegebene Spalten festzulegen. Sie können das ErrorProvider -Steuerelement verwenden, um den Text des Fehlers anzuzeigen.

Verwenden Sie die GetColumnError -Methode, um Fehlerbeschreibungen zu untersuchen.

Verwenden Sie die -Eigenschaft, um zu bestimmen, ob Fehler für die HasErrors Spaltenauflistung vorhanden sind. Folglich können Sie die GetColumnsInError -Methode verwenden, um alle Spalten mit Fehlern abzurufen.

Wenn null oder eine leere Zeichenfolge als error Parameter übergeben wird, verhält sich das DataRow so, als ob kein Fehler festgelegt wurde, und die HasErrors Eigenschaft gibt false zurück.

Verwenden Sie die -Eigenschaft, um eine benutzerdefinierte Fehlerbeschreibung für die RowError gesamte Zeile festzulegen.

Verwenden Sie die ClearErrors -Methode, um alle Fehler für die Spaltenauflistung zu löschen.

Um Fehlertext festzulegen, der für eine ganze Zeile gilt, legen Sie die RowError -Eigenschaft fest.

Weitere Informationen

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

SetColumnError(String, String)

Quelle:

DataRow.cs

Legt die Fehlerbeschreibung für eine durch den Namen angegebene Spalte fest.

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)

Parameter

columnName

String

Der Name der Spalte.

error

String

Die Fehlerbeschreibung.

Beispiele

Im folgenden Beispiel wird eine Fehlerbeschreibung für eine angegebene DataRowfestgelegt.

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

Hinweise

Der Name einer Spalte wird mit der ColumnName -Eigenschaft der DataColumn -Klasse festgelegt.

Verwenden Sie die GetColumnError -Methode, um Fehlerbeschreibungen zu untersuchen.

Verwenden Sie die -Eigenschaft, um zu bestimmen, ob Fehler für die HasErrors Spaltenauflistung vorhanden sind. Folglich können Sie die GetColumnsInError -Methode verwenden, um alle Spalten mit Fehlern abzurufen.

Wenn null oder eine leere Zeichenfolge als error Parameter übergeben wird, verhält sich das DataRow so, als ob kein Fehler festgelegt wurde, und die HasErrors Eigenschaft gibt false zurück.

Verwenden Sie die -Eigenschaft, um eine benutzerdefinierte Fehlerbeschreibung für die RowError gesamte Zeile festzulegen.

Verwenden Sie die HasErrors -Methode, um zu bestimmen, ob Fehler für die Spaltenauflistung vorhanden sind.

Verwenden Sie die ClearErrors -Methode, um alle Fehler für die Spaltenauflistung zu löschen.

Weitere Informationen

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