DataRow.SetColumnError Método

Definición

Establece la descripción de error para una columna.Sets the error description for a column.

Sobrecargas

SetColumnError(DataColumn, String)

Establece la descripción de error para una columna especificada como DataColumn.Sets the error description for a column specified as a DataColumn.

SetColumnError(Int32, String)

Establece la descripción de error para una columna especificada mediante un índice.Sets the error description for a column specified by index.

SetColumnError(String, String)

Establece la descripción de error para una columna especificada mediante un nombre.Sets the error description for a column specified by name.

SetColumnError(DataColumn, String)

Establece la descripción de error para una columna especificada como 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);
member this.SetColumnError : System.Data.DataColumn * string -> unit
Public Sub SetColumnError (column As DataColumn, error As String)

Parámetros

column
DataColumn

DataColumn para el que se va a establecer la descripción de error.The DataColumn to set the error description for.

error
String

Descripción de error.The error description.

Ejemplos

En el ejemplo siguiente se establece una descripción de error para una DataRowespecificada.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

Comentarios

Para examinar descripciones de errores, utilice el método GetColumnError.To examine error descriptions, use the GetColumnError method.

Para determinar si existe algún error en la colección de columnas, use la propiedad HasErrors.To determine whether any errors exist for the columns collection, use the HasErrors property. Por consiguiente, puede utilizar el método GetColumnsInError para recuperar todas las columnas con errores.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Si null o una cadena vacía se pasa como parámetro error, la DataRow se comporta como si no se hubiera establecido ningún error y la propiedad HasErrors devolverá 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.

Para establecer una descripción de error personalizada en toda la fila, use la propiedad RowError.To set a custom error description on the whole row, use the RowError property.

Para determinar si existe algún error en la colección de columnas, utilice el método HasErrors.To determine whether any errors exist for the columns collection, use the HasErrors method.

Para borrar todos los errores de la colección de columnas, utilice el método ClearErrors.To clear all errors for the columns collection, use the ClearErrors method.

Consulte también:

SetColumnError(Int32, String)

Establece la descripción de error para una columna especificada mediante un índice.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)

Parámetros

columnIndex
Int32

Índice de base cero de la columna.The zero-based index of the column.

error
String

Descripción de error.The error description.

Excepciones

El argumento columnIndex está fuera de intervalo.The columnIndex argument is out of range

Ejemplos

En el ejemplo siguiente se establece una descripción de error para una DataRowespecificada.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

Comentarios

El método se utiliza para establecer descripciones de error personalizadas en columnas especificadas.The method is used to set custom error descriptions on specified columns. Puede usar el control ErrorProvider para mostrar el texto del error.You can use the ErrorProvider control to display the text of the error.

Para examinar descripciones de errores, utilice el método GetColumnError.To examine error descriptions, use the GetColumnError method.

Para determinar si existe algún error en la colección de columnas, use la propiedad HasErrors.To determine whether any errors exist for the columns collection, use the HasErrors property. Por consiguiente, puede utilizar el método GetColumnsInError para recuperar todas las columnas con errores.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Si null o una cadena vacía se pasa como parámetro error, la DataRow se comporta como si no se hubiera establecido ningún error y la propiedad HasErrors devolverá 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.

Para establecer una descripción de error personalizada en toda la fila, use la propiedad RowError.To set a custom error description on the whole row, use the RowError property.

Para borrar todos los errores de la colección de columnas, utilice el método ClearErrors.To clear all errors for the columns collection, use the ClearErrors method.

Para establecer el texto de error que se aplica a una fila completa, establezca la propiedad RowError.To set error text that applies to a whole row, set the RowError property.

Consulte también:

SetColumnError(String, String)

Establece la descripción de error para una columna especificada mediante un nombre.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)

Parámetros

columnName
String

El nombre de la columna.The name of the column.

error
String

Descripción de error.The error description.

Ejemplos

En el ejemplo siguiente se establece una descripción de error para una DataRowespecificada.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

Comentarios

El nombre de una columna se establece con la propiedad ColumnName de la clase DataColumn.The name of a column is set with the ColumnName property of the DataColumn class.

Para examinar descripciones de errores, utilice el método GetColumnError.To examine error descriptions, use the GetColumnError method.

Para determinar si existe algún error en la colección de columnas, use la propiedad HasErrors.To determine whether any errors exist for the columns collection, use the HasErrors property. Por consiguiente, puede utilizar el método GetColumnsInError para recuperar todas las columnas con errores.Consequently, you can use the GetColumnsInError method to retrieve all the columns with errors.

Si null o una cadena vacía se pasa como parámetro error, la DataRow se comporta como si no se hubiera establecido ningún error y la propiedad HasErrors devolverá 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.

Para establecer una descripción de error personalizada en toda la fila, use la propiedad RowError.To set a custom error description on the whole row, use the RowError property.

Para determinar si existe algún error en la colección de columnas, utilice el método HasErrors.To determine whether any errors exist for the columns collection, use the HasErrors method.

Para borrar todos los errores de la colección de columnas, utilice el método ClearErrors.To clear all errors for the columns collection, use the ClearErrors method.

Consulte también:

Se aplica a