Clase SqlCeError

Artículo
05/27/2011

Recopila información relacionada con una advertencia o un error devuelto por el origen de datos. No se puede heredar esta clase.

Jerarquía de herencia

System.Object
System.Data.SqlServerCe.SqlCeError

Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Sintaxis

'Declaración
<SerializableAttribute> _
Public NotInheritable Class SqlCeError
'Uso
Dim instance As SqlCeError

[SerializableAttribute]
public sealed class SqlCeError

[SerializableAttribute]
public ref class SqlCeError sealed

[<SealedAttribute>]
[<SerializableAttribute>]
type SqlCeError =  class end

public final class SqlCeError

El tipo SqlCeError expone los siguientes miembros.

Propiedades

	Nombre	Descripción
	ErrorParameters	Obtiene los tres últimos parámetros de error. SQL Server Compact utiliza los parámetros de error para proporcionar información detallada adicional sobre un error.
	HResult	Devuelve un valor HRESULT que identifica el tipo de error.
	Message	Obtiene el texto que describe el error.
	NativeError	Obtiene el número del error nativo de SqlCeError. Para obtener más información sobre estos errores, vea el tema "SQL Server Compact Errors" (Errores de ssEW) en la sección Troubleshooting de los libros en pantalla de SQL Server Compact.
	NumericErrorParameters	Obtiene los tres primeros parámetros de error. SQL Server Compact utiliza los parámetros de error para proporcionar información detallada adicional sobre un error.
	Source	Obtiene el nombre del proveedor que ha generado el error.

Arriba

Métodos

	Nombre	Descripción
	Equals	(se hereda de Object)
	Finalize	(se hereda de Object)
	GetHashCode	(se hereda de Object)
	GetType	(se hereda de Object)
	MemberwiseClone	(se hereda de Object)
	ToString	Obtiene el texto completo del mensaje de error. (Invalida Object.ToString().)

Arriba

Comentarios

El proveedor administrado de System.Data.SqlServerCe crea una instancia de SqlCeError cuando se produce un error. SqlCeErrorCollection contiene una o varias instancias de SqlCeError.

Ejemplos

En el siguiente ejemplo se muestra el uso habitual de SqlCeError.

Try
    Dim repl As New SqlCeReplication()

    ' Fill repl properites here
    ' ...
    ' SqlCeReplication may throw SqlCeException which contains a 
    ' collection of errors; SQL Mobile database engine always
    ' returns one error in the collection
    '
    repl.Synchronize()
Catch e As SqlCeException
    Dim err As SqlCeError
    For Each err In e.Errors
        ' Use SqlCeError properties if you need specific
        ' application logic depending on the error condition
        '
        If 28577 = [err].NativeError Then 'SSCE_M_SCHEMAHASCHANGED
            ' Error specific logic goes here...
            '
        End If

        ' Note: For native error numbers, refer to SQL Server Mobile Errors
        ' in the SQL Server Mobile Books Online
        '
        MessageBox.Show([err].Message)
    Next err
End Try

try
{
    SqlCeReplication repl = new SqlCeReplication();

    // Fill repl properites here
    // ...

    // SqlCeReplication may throw SqlCeException which contains a 
    // collection of errors; SQL Mobile database engine always
    // returns one error in the collection
    //
    repl.Synchronize();
}
catch (SqlCeException e)
{
    foreach (SqlCeError error in e.Errors)
    {
        // Use SqlCeError properties if you need specific
        // application logic depending on the error condition
        //
        if (28577 == error.NativeError /*SSCE_M_SCHEMAHASCHANGED*/)
        {
            // Error specific logic goes here...
            //
        }

        // Note: For native error numbers, refer to SQL Server Mobile Errors
        // in the SQL Server Mobile Books Online
        //
        MessageBox.Show(error.Message);
    }
}

Seguridad para subprocesos

Todos los miembros estáticos públicos (Shared in Microsoft Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.