DataRow.SetColumnError Metoda

Definicja

Ustawia opis błędu dla kolumny.Sets the error description for a column.

Przeciążenia

SetColumnError(DataColumn, String)

Ustawia opis błędu dla kolumny określonej jako DataColumn .Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String)

Ustawia opis błędu dla kolumny określonej przez indeks.Sets the error description for a column specified by index.

SetColumnError(String, String)

Ustawia opis błędu dla kolumny określonej przez nazwę.Sets the error description for a column specified by name.

SetColumnError(DataColumn, String)

Ustawia opis błędu dla kolumny określonej jako 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)

Parametry

column
DataColumn

, DataColumn Aby ustawić opis błędu dla.The DataColumn to set the error description for.

error
String

Opis błędu.The error description.

Przykłady

Poniższy przykład ustawia opis błędu dla określonego 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

Uwagi

Aby zapoznać się z opisami błędów, użyj GetColumnError metody.To examine error descriptions, use the GetColumnError method.

Aby ustalić, czy istnieją jakieś błędy dla kolekcji kolumn, użyj HasErrors właściwości.To determine whether any errors exist for the columns collection, use the HasErrors property. W związku z tym można użyć GetColumnsInError metody, aby pobrać wszystkie kolumny z błędami.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Jeśli null lub pusty ciąg jest przekazano jako error parametr, DataRow zachowuje się tak, jakby nie został ustawiony błąd i HasErrors właściwość zwróci wartość 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.

Aby ustawić niestandardowy opis błędu dla całego wiersza, użyj RowError właściwości.To set a custom error description on the whole row, use the RowError property.

Aby ustalić, czy istnieją jakieś błędy dla kolekcji kolumn, użyj HasErrors metody.To determine whether any errors exist for the columns collection, use the HasErrors method.

Aby wyczyścić wszystkie błędy dla kolekcji Columns, użyj ClearErrors metody.To clear all errors for the columns collection, use the ClearErrors method.

Zobacz też

Dotyczy

SetColumnError(Int32, String)

Ustawia opis błędu dla kolumny określonej przez indeks.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)

Parametry

columnIndex
Int32

Indeks kolumny liczony od zera.The zero-based index of the column.

error
String

Opis błędu.The error description.

Wyjątki

columnIndexArgument jest poza zakresemThe columnIndex argument is out of range

Przykłady

Poniższy przykład ustawia opis błędu dla określonego 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

Uwagi

Metoda służy do ustawiania niestandardowych opisów błędów w określonych kolumnach.The method is used to set custom error descriptions on specified columns. Możesz użyć ErrorProvider kontrolki, aby wyświetlić tekst błędu.You can use the ErrorProvider control to display the text of the error.

Aby zapoznać się z opisami błędów, użyj GetColumnError metody.To examine error descriptions, use the GetColumnError method.

Aby ustalić, czy istnieją jakieś błędy dla kolekcji kolumn, użyj HasErrors właściwości.To determine whether any errors exist for the columns collection, use the HasErrors property. W związku z tym można użyć GetColumnsInError metody, aby pobrać wszystkie kolumny z błędami.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Jeśli null lub pusty ciąg jest przekazano jako error parametr, DataRow zachowuje się tak, jakby nie został ustawiony błąd i HasErrors właściwość zwróci wartość 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.

Aby ustawić niestandardowy opis błędu dla całego wiersza, użyj RowError właściwości.To set a custom error description on the whole row, use the RowError property.

Aby wyczyścić wszystkie błędy dla kolekcji Columns, użyj ClearErrors metody.To clear all errors for the columns collection, use the ClearErrors method.

Aby ustawić tekst błędu, który ma zastosowanie do całego wiersza, ustaw RowError Właściwość.To set error text that applies to a whole row, set the RowError property.

Zobacz też

Dotyczy

SetColumnError(String, String)

Ustawia opis błędu dla kolumny określonej przez nazwę.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)

Parametry

columnName
String

Nazwa kolumny.The name of the column.

error
String

Opis błędu.The error description.

Przykłady

Poniższy przykład ustawia opis błędu dla określonego 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

Uwagi

Nazwa kolumny jest ustawiana z ColumnName właściwością DataColumn klasy.The name of a column is set with the ColumnName property of the DataColumn class.

Aby zapoznać się z opisami błędów, użyj GetColumnError metody.To examine error descriptions, use the GetColumnError method.

Aby ustalić, czy istnieją jakieś błędy dla kolekcji kolumn, użyj HasErrors właściwości.To determine whether any errors exist for the columns collection, use the HasErrors property. W związku z tym można użyć GetColumnsInError metody, aby pobrać wszystkie kolumny z błędami.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Jeśli null lub pusty ciąg jest przekazano jako error parametr, DataRow zachowuje się tak, jakby nie został ustawiony błąd i HasErrors właściwość zwróci wartość 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.

Aby ustawić niestandardowy opis błędu dla całego wiersza, użyj RowError właściwości.To set a custom error description on the whole row, use the RowError property.

Aby ustalić, czy istnieją jakieś błędy dla kolekcji kolumn, użyj HasErrors metody.To determine whether any errors exist for the columns collection, use the HasErrors method.

Aby wyczyścić wszystkie błędy dla kolekcji Columns, użyj ClearErrors metody.To clear all errors for the columns collection, use the ClearErrors method.

Zobacz też

Dotyczy