DataRow.SetColumnError Methode

  • Referenz

Definition

Namespace:
System.Data
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.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)

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

Hinweise

Um Fehlerbeschreibungen zu untersuchen, verwenden Sie die GetColumnError Methode.

Um zu ermitteln, ob fehler für die Spaltensammlung vorhanden sind, verwenden Sie die HasErrors Eigenschaft. 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 die Eigenschaft so, als ob kein Fehler festgelegt wurde, und die DataRow HasErrors Eigenschaft gibt false zurück.

Um eine benutzerdefinierte Fehlerbeschreibung in der gesamten Zeile festzulegen, verwenden Sie die RowError Eigenschaft.

Um zu ermitteln, ob fehler für die Spaltensammlung vorhanden sind, verwenden Sie die HasErrors Methode.

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

Siehe auch

Gilt für

SetColumnError(Int32, String)

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

Hinweise

Die Methode wird verwendet, um benutzerdefinierte Fehlerbeschreibungen auf angegebenen Spalten festzulegen. Sie können das Steuerelement verwenden, um den ErrorProvider Text des Fehlers anzuzeigen.

Um Fehlerbeschreibungen zu untersuchen, verwenden Sie die GetColumnError Methode.

Um zu ermitteln, ob fehler für die Spaltensammlung vorhanden sind, verwenden Sie die HasErrors Eigenschaft. 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 die Eigenschaft so, als ob kein Fehler festgelegt wurde, und die DataRow HasErrors Eigenschaft gibt false zurück.

Um eine benutzerdefinierte Fehlerbeschreibung in der gesamten Zeile festzulegen, verwenden Sie die RowError Eigenschaft.

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

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

Siehe auch

Gilt für

SetColumnError(String, String)

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

Hinweise

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

Um Fehlerbeschreibungen zu untersuchen, verwenden Sie die GetColumnError Methode.

Um zu ermitteln, ob fehler für die Spaltensammlung vorhanden sind, verwenden Sie die HasErrors Eigenschaft. 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 die Eigenschaft so, als ob kein Fehler festgelegt wurde, und die DataRow HasErrors Eigenschaft gibt false zurück.

Um eine benutzerdefinierte Fehlerbeschreibung in der gesamten Zeile festzulegen, verwenden Sie die RowError Eigenschaft.

Um zu ermitteln, ob fehler für die Spaltensammlung vorhanden sind, verwenden Sie die HasErrors Methode.

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

Siehe auch

Gilt für