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
	SqlCeException	Konstruktor, der die Serialisierung unterstützt.

Zum Anfang

Eigenschaften

	Name	Beschreibung
	Data	(von Exception vererbt)
	ErrorCode	(von ExternalException vererbt)
	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.
	HelpLink	(von Exception vererbt)
	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.
	InnerException	(von Exception vererbt)
	Message	Ruft den Text ab, der die erste Instanz der SqlCeError-Klasse in der SqlCeErrorCollection-Klasse für diese Ausnahme beschreibt. (Überschreibt Exception.Message.)
	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".
	Source	Ruft den Namen des OLE DB-Anbieters ab, der den Fehler generiert hat. (Überschreibt Exception.Source.)
	StackTrace	(von Exception vererbt)
	TargetSite	(von Exception vererbt)

Zum Anfang

Methoden

	Name	Beschreibung
	Equals	(von Object vererbt)
	Finalize	(von Object vererbt)
	GetBaseException	(von Exception vererbt)
	GetHashCode	(von Object vererbt)
	GetObjectData	Sicherheitskritisch Füllt ein SerializationInfo-Element mit den erforderlichen Daten zum Serialisieren des Objekts auf. (Überschreibt Exception.GetObjectData(SerializationInfo, StreamingContext).)
	GetType	(von Exception vererbt)
	MemberwiseClone	(von Object vererbt)
	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