DataRow.SetColumnError Methode

Definition

Legt die Fehlerbeschreibung für eine Spalte fest.Sets the error description for a column.

Überlädt

SetColumnError(DataColumn, String)

Legt die Fehlerbeschreibung für eine als DataColumn angegebene Spalte fest.Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String)

Legt die Fehlerbeschreibung für eine durch den Index angegebene Spalte fest.Sets the error description for a column specified by index.

SetColumnError(String, String)

Legt die Fehlerbeschreibung für eine durch den Namen angegebene Spalte fest.Sets the error description for a column specified by name.

SetColumnError(DataColumn, String)

Legt die Fehlerbeschreibung für eine als DataColumn angegebene Spalte fest.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)

Parameter

column
DataColumn

Die DataColumn, für die die Fehlerbeschreibung festgelegt werden soll.The DataColumn to set the error description for.

error
String

Die Fehlerbeschreibung.The error description.

Beispiele

Im folgenden Beispiel wird eine Fehlerbeschreibung für eine angegebene DataRowfestgelegt.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

Hinweise

Verwenden Sie die GetColumnError -Methode, um Fehlerbeschreibungen zu untersuchen.To examine error descriptions, use the GetColumnError method.

Verwenden Sie die HasErrors -Eigenschaft, um zu bestimmen, ob für die Columns-Auflistung Fehler vorhanden sind.To determine whether any errors exist for the columns collection, use the HasErrors property. Folglich können Sie die GetColumnsInError -Methode verwenden, um alle Spalten mit Fehlern abzurufen.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Wenn null oder eine leere Zeichenfolge error als-Parameter übergeben wird, DataRow verhält sich wie, wenn kein Fehler festgelegt wurde HasErrors und die-Eigenschaft false zurückgibt.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.

Verwenden Sie die RowError -Eigenschaft, um eine benutzerdefinierte Fehlerbeschreibung für die gesamte Zeile festzulegen.To set a custom error description on the whole row, use the RowError property.

Verwenden Sie die HasErrors -Methode, um zu bestimmen, ob für die Columns-Auflistung Fehler vorhanden sind.To determine whether any errors exist for the columns collection, use the HasErrors method.

Verwenden Sie die ClearErrors -Methode, um alle Fehler für die Columns-Auflistung zu löschen.To clear all errors for the columns collection, use the ClearErrors method.

Siehe auch

SetColumnError(Int32, String)

Legt die Fehlerbeschreibung für eine durch den Index angegebene Spalte fest.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)

Parameter

columnIndex
Int32

Der nullbasierte Index der Spalte.The zero-based index of the column.

error
String

Die Fehlerbeschreibung.The error description.

Ausnahmen

Das columnIndex-Argument liegt außerhalb des gültigen Bereichs.The columnIndex argument is out of range

Beispiele

Im folgenden Beispiel wird eine Fehlerbeschreibung für eine angegebene DataRowfestgelegt.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

Hinweise

Die-Methode wird verwendet, um benutzerdefinierte Fehlerbeschreibungen für angegebene Spalten festzulegen.The method is used to set custom error descriptions on specified columns. Sie können das- ErrorProvider Steuerelement verwenden, um den Text des Fehlers anzuzeigen.You can use the ErrorProvider control to display the text of the error.

Verwenden Sie die GetColumnError -Methode, um Fehlerbeschreibungen zu untersuchen.To examine error descriptions, use the GetColumnError method.

Verwenden Sie die HasErrors -Eigenschaft, um zu bestimmen, ob für die Columns-Auflistung Fehler vorhanden sind.To determine whether any errors exist for the columns collection, use the HasErrors property. Folglich können Sie die GetColumnsInError -Methode verwenden, um alle Spalten mit Fehlern abzurufen.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Wenn null oder eine leere Zeichenfolge error als-Parameter übergeben wird, DataRow verhält sich wie, wenn kein Fehler festgelegt wurde HasErrors und die-Eigenschaft false zurückgibt.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.

Verwenden Sie die RowError -Eigenschaft, um eine benutzerdefinierte Fehlerbeschreibung für die gesamte Zeile festzulegen.To set a custom error description on the whole row, use the RowError property.

Verwenden Sie die ClearErrors -Methode, um alle Fehler für die Columns-Auflistung zu löschen.To clear all errors for the columns collection, use the ClearErrors method.

Um den Fehlertext festzulegen, der für eine ganze Zeile gilt RowError , legen Sie die-Eigenschaft fest.To set error text that applies to a whole row, set the RowError property.

Siehe auch

SetColumnError(String, String)

Legt die Fehlerbeschreibung für eine durch den Namen angegebene Spalte fest.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)

Parameter

columnName
String

Der Name der Spalte.The name of the column.

error
String

Die Fehlerbeschreibung.The error description.

Beispiele

Im folgenden Beispiel wird eine Fehlerbeschreibung für eine angegebene DataRowfestgelegt.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

Hinweise

Der Name einer Spalte wird mit der ColumnName -Eigenschaft DataColumn der-Klasse festgelegt.The name of a column is set with the ColumnName property of the DataColumn class.

Verwenden Sie die GetColumnError -Methode, um Fehlerbeschreibungen zu untersuchen.To examine error descriptions, use the GetColumnError method.

Verwenden Sie die HasErrors -Eigenschaft, um zu bestimmen, ob für die Columns-Auflistung Fehler vorhanden sind.To determine whether any errors exist for the columns collection, use the HasErrors property. Folglich können Sie die GetColumnsInError -Methode verwenden, um alle Spalten mit Fehlern abzurufen.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Wenn null oder eine leere Zeichenfolge error als-Parameter übergeben wird, DataRow verhält sich wie, wenn kein Fehler festgelegt wurde HasErrors und die-Eigenschaft false zurückgibt.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.

Verwenden Sie die RowError -Eigenschaft, um eine benutzerdefinierte Fehlerbeschreibung für die gesamte Zeile festzulegen.To set a custom error description on the whole row, use the RowError property.

Verwenden Sie die HasErrors -Methode, um zu bestimmen, ob für die Columns-Auflistung Fehler vorhanden sind.To determine whether any errors exist for the columns collection, use the HasErrors method.

Verwenden Sie die ClearErrors -Methode, um alle Fehler für die Columns-Auflistung zu löschen.To clear all errors for the columns collection, use the ClearErrors method.

Siehe auch

Gilt für: