Freigeben über


SqlCeException-Klasse

Die Ausnahme, die ausgelöst wird, wenn der zugrunde liegende Anbieter eine Warnung oder einen Fehler für eine SQL Server Compact-Datenquelle zurückgibt. Diese Klasse kann nicht vererbt werden.

Vererbungshierarchie

System.Object
  System.Exception
    System.SystemException
      System.Runtime.InteropServices.ExternalException
        System.Data.Common.DbException
          System.Data.SqlServerCe.SqlCeException
            System.Data.SqlServerCe.SqlCeInvalidDatabaseFormatException
            System.Data.SqlServerCe.SqlCeLockTimeoutException
            System.Data.SqlServerCe.SqlCeTransactionInProgressException

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

Syntax

'Declaration
<SerializableAttribute> _
Public Class SqlCeException _
    Inherits DbException
'Usage
Dim instance As SqlCeException
[SerializableAttribute]
public class SqlCeException : DbException
[SerializableAttribute]
public ref class SqlCeException : public DbException
[<SerializableAttribute>]
type SqlCeException =  
    class
        inherit DbException
    end
public class SqlCeException extends DbException

Der SqlCeException-Typ macht folgende Elemente verfügbar.

Konstruktoren

  Name Beschreibung
Geschützte Methode SqlCeException Konstruktor, der die Serialisierung unterstützt.

Zum Anfang

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft Data (von Exception vererbt)
Öffentliche Eigenschaft ErrorCode (von ExternalException vererbt)
Öffentliche Eigenschaft Errors Ruft eine Auflistung von mindestens einem SqlCeError-Objekt ab, die detaillierte Informationen über die vom .NET Compact Framework-Datenanbieter für SQL Server Compact generierten Ausnahmen enthält.
Öffentliche Eigenschaft HelpLink (von Exception vererbt)
Öffentliche Eigenschaft HResult Ruft den HRESULT-Wert der Ausnahme ab. Dieser Wert entspricht dem Wert der HResult-Eigenschaft für die erste Instanz der SqlCeError-Klasse in der SqlCeErrorCollection-Klasse für die Ausnahme.
Öffentliche Eigenschaft InnerException (von Exception vererbt)
Öffentliche Eigenschaft Message Ruft den Text ab, der die erste Instanz der SqlCeError-Klasse in der SqlCeErrorCollection-Klasse für diese Ausnahme beschreibt. (Überschreibt Exception.Message.)
Öffentliche Eigenschaft NativeError Ruft die systemeigene Fehlernummer der ersten SqlCeError-Klasse in der SqlCeErrorCollection-Auflistung ab. Weitere Informationen zu dem Fehler finden Sie in der Onlinedokumentation zu SQL Server Compact unter dem Thema "Fehler bei SQL Server Compact" im Abschnitt "Problembehandlung".
Öffentliche Eigenschaft Source Ruft den Namen des OLE DB-Anbieters ab, der den Fehler generiert hat. (Überschreibt Exception.Source.)
Öffentliche Eigenschaft StackTrace (von Exception vererbt)
Öffentliche Eigenschaft TargetSite (von Exception vererbt)

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode Equals (von Object vererbt)
Geschützte Methode Finalize (von Object vererbt)
Öffentliche Methode GetBaseException (von Exception vererbt)
Öffentliche Methode GetHashCode (von Object vererbt)
Öffentliche Methode GetObjectData Sicherheitskritisch Füllt ein SerializationInfo-Element mit den erforderlichen Daten zum Serialisieren des Objekts auf. (Überschreibt Exception.GetObjectData(SerializationInfo, StreamingContext).)
Öffentliche Methode GetType (von Exception vererbt)
Geschützte Methode MemberwiseClone (von Object vererbt)
Öffentliche Methode ToString (von Exception vererbt)

Zum Anfang

Hinweise

Diese Klasse wird immer erstellt, wenn der .NET Compact Framework-Datenanbieter für SQL Server Compact einen von der SQL Server Compact-Engine generierten Fehler entdeckt. (Andere Fehler werden als Standardausnahmen der Common Language Runtime ausgelöst.) SqlCeException enthält stets mindestens eine Instanz der SqlCeError-Klasse.

Beispiele

Im folgenden Beispiel wird wegen einer fehlenden Datenquelle eine SqlCeException-Ausnahme generiert, und die Ausnahme wird anschließend angezeigt.

Dim conn As New SqlCeConnection("Data Source=nonExistingSource.sdf;")

Try
    conn.Open()
Catch e As SqlCeException
    ' Use SqlCeException properties if you need specific
    ' application logic depending on the error condition
    '
    If 25046 = e.NativeError Then 'SSCE_M_FILENOTFOUND
        ' Error specific logic goes here...
        '
    End If

    MessageBox.Show(e.Message)
End Try
SqlCeConnection conn = new SqlCeConnection("Data Source=nonExistingSource.sdf;");

try
{
    conn.Open();
}
catch (SqlCeException e)
{
    // Use SqlCeException properties if you need specific
    // application logic depending on the error condition
    //
    if (25046 == e.NativeError /*SSCE_M_FILENOTFOUND*/)
    {
        // Error specific logic goes here...
        //
    }

    MessageBox.Show(e.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

SqlCeError

SqlCeErrorCollection