SqlCeError-Klasse

Sammelt Informationen zu einer von der Datenquelle zurückgegebenen Warnung oder einem Fehler. Diese Klasse kann nicht vererbt werden.

Vererbungshierarchie

System.Object
  System.Data.SqlServerCe.SqlCeError

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (in System.Data.SqlServerCe.dll)

Syntax

'Declaration
<SerializableAttribute> _
Public NotInheritable Class SqlCeError
'Usage
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

Der SqlCeError-Typ macht folgende Elemente verfügbar.

Eigenschaften

	Name	Beschreibung
	ErrorParameters	Ruft die letzten drei Fehlerparameter ab. Anhand von Fehlerparametern stellt SQL Server Compact zusätzliche Details zu einem Fehler bereit.
	HResult	Gibt einen HRESULT-Wert zurück, der den Fehlertyp bezeichnet.
	Message	Ruft den Text ab, der den Fehler beschreibt.
	NativeError	Ruft die systemeigene Fehlernummer der SqlCeError-Klasse ab. Weitere Informationen zu diesen Fehlern finden Sie in der Onlinedokumentation zu SQL Server Compact unter dem Thema "SQL Server Compact Errors" im Abschnitt "Troubleshooting".
	NumericErrorParameters	Ruft die ersten drei Fehlerparameter ab. Anhand von Fehlerparametern stellt SQL Server Compact zusätzliche Details zu einem Fehler bereit.
	Source	Ruft den Namen des Anbieters ab, der den Fehler generiert hat.

Zum Anfang

Methoden

	Name	Beschreibung
	Equals	(von Object vererbt)
	Finalize	(von Object vererbt)
	GetHashCode	(von Object vererbt)
	GetType	(von Object vererbt)
	MemberwiseClone	(von Object vererbt)
	ToString	Ruft den vollständigen Text der Fehlermeldung ab. (Überschreibt Object.ToString().)

Zum Anfang

Hinweise

Wenn ein Fehler auftritt, wird eine Instanz von SqlCeError durch den vom System.Data.SqlServerCe-Namespace verwalteten Anbieter erstellt. Die SqlCeErrorCollection-Klasse enthält mindestens eine Instanz der SqlCeError-Klasse.

Beispiele

Im folgenden Beispiel wird eine typische Verwendung der SqlCeError-Klasse veranschaulicht.

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

Threadsicherheit

Alle öffentlichen statischen (in Microsoft Visual Basic freigegebenen) Elemente dieses Typs sind threadsicher. Für Instanzelemente kann nicht sichergestellt werden, dass sie threadsicher sind.

Siehe auch

Verweis

System.Data.SqlServerCe-Namespace

SqlCeErrorCollection

SqlCeException