Freigeben über


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
Öffentliche Eigenschaft ErrorParameters Ruft die letzten drei Fehlerparameter ab. Anhand von Fehlerparametern stellt SQL Server Compact zusätzliche Details zu einem Fehler bereit.
Öffentliche Eigenschaft HResult Gibt einen HRESULT-Wert zurück, der den Fehlertyp bezeichnet.
Öffentliche Eigenschaft Message Ruft den Text ab, der den Fehler beschreibt.
Öffentliche Eigenschaft 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".
Öffentliche Eigenschaft NumericErrorParameters Ruft die ersten drei Fehlerparameter ab. Anhand von Fehlerparametern stellt SQL Server Compact zusätzliche Details zu einem Fehler bereit.
Öffentliche Eigenschaft Source Ruft den Namen des Anbieters ab, der den Fehler generiert hat.

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode Equals (von Object vererbt)
Geschützte Methode Finalize (von Object vererbt)
Öffentliche Methode GetHashCode (von Object vererbt)
Öffentliche Methode GetType (von Object vererbt)
Geschützte Methode MemberwiseClone (von Object vererbt)
Öffentliche Methode 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