SqlCeConnection-Klasse

Stellt eine offene Verbindung mit einer SQL Server Compact-Datenquelle dar.

Vererbungshierarchie

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbConnection
        System.Data.SqlServerCe.SqlCeConnection

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

Syntax

'Declaration
Public NotInheritable Class SqlCeConnection _
    Inherits DbConnection
'Usage
Dim instance As SqlCeConnection

public sealed class SqlCeConnection : DbConnection

public ref class SqlCeConnection sealed : public DbConnection

[<SealedAttribute>]
type SqlCeConnection =  
    class
        inherit DbConnection
    end

public final class SqlCeConnection extends DbConnection

Der SqlCeConnection-Typ macht folgende Elemente verfügbar.

Konstruktoren

	Name	Beschreibung
	SqlCeConnection()	Initialisiert eine neue Instanz der SqlCeConnection-Klasse.
	SqlCeConnection(String)	Initialisiert eine neue Instanz der SqlCeConnection-Klasse mit der angegebenen Verbindungszeichenfolge.

Zum Anfang

Eigenschaften

	Name	Beschreibung
	CanRaiseEvents	(von Component vererbt)
	ConnectionString	Ruft die Zeichenfolge ab, mit der eine Datenbank geöffnet wird, oder legt diese fest. (Überschreibt DbConnection.ConnectionString.)
	ConnectionTimeout	Ruft die Zeit ab, die beim Verbindungsaufbau gewartet werden soll, bis der Versuch beendet und ein Fehler generiert wird. (Überschreibt DbConnection.ConnectionTimeout.)
	Container	(von Component vererbt)
	Database	Ruft den Namen der aktuellen Datenbank oder der bei einer geöffneten Verbindung zu verwendenden Datenbank ab. (Überschreibt DbConnection.Database.)
	DatabaseIdentifier	Ruft während der Synchronisierung den eindeutigen Bezeichner der aktuellen Datenbank ab.
	DataSource	Ruft den Dateinamen der Datenquelle ab. (Überschreibt DbConnection.DataSource.)
	DbProviderFactory	(von DbConnection vererbt)
	DesignMode	(von Component vererbt)
	Events	(von Component vererbt)
	ServerVersion	Gibt die Datenbankversionsnummer als Zeichenfolge zurück. (Überschreibt DbConnection.ServerVersion.)
	Site	(von Component vererbt)
	State	Ruft den aktuellen Zustand der Verbindung ab. (Überschreibt DbConnection.State.)

Zum Anfang

Methoden

	Name	Beschreibung
	BeginDbTransaction	(von DbConnection vererbt)
	BeginTransaction()	Beginnt eine Datenbanktransaktion.
	BeginTransaction(IsolationLevel)	Beginnt eine Datenbanktransaktion mit dem aktuellen IsolationLevel-Wert.
	ChangeDatabase	Wechselt die aktuelle Datenbank für ein geöffnetes SqlCeConnection-Element. (Überschreibt DbConnection.ChangeDatabase(String).)
	Close	Schließt die Verbindung mit der Datenquelle. Dies ist die empfohlene Vorgehensweise zum Schließen offener Verbindungen. (Überschreibt DbConnection.Close().)
	CreateCommand	Erstellt ein SqlCeCommand-Objekt, das der SqlCeConnection-Klasse zugeordnet ist, und gibt es zurück.
	CreateDbCommand	(von DbConnection vererbt)
	CreateObjRef	(von MarshalByRefObject vererbt)
	Dispose()	Gibt alle Ressourcen frei, die von der aktuellen Instanz der SqlCeConnection-Klasse verwendet werden.
	Dispose(Boolean)	(von Component vererbt)
	EnlistTransaction(Transaction)	(von DbConnection vererbt)
	EnlistTransaction(Transaction)	Nimmt einen Eintrag in der angegebenen Transaction vor.
	Equals	(von Object vererbt)
	Finalize	(von Component vererbt)
	GetDatabaseInfo	Gibt einen Satz von Schlüssel-Wert-Paaren mit Informationen über das Gebietsschema, den Verschlüsselungsmodus und die Einstellung für die Berücksichtigung der Groß-/Kleinschreibung der verbundenen Datenbank zurück.
	GetHashCode	(von Object vererbt)
	GetLifetimeService	(von MarshalByRefObject vererbt)
	GetSchema()	Gibt Schemainformationen für die Datenquelle dieses SqlCeConnection-Objekts zurück. (Überschreibt DbConnection.GetSchema().)
	GetSchema(String)	Gibt Schemainformationen für die Datenquelle dieses SqlCeConnection-Objekts mithilfe der angegebenen Zeichenfolge für den Schemanamen zurück. (Überschreibt DbConnection.GetSchema(String).)
	GetSchema(String, array<String[])	Gibt Schemainformationen für die Datenquelle dieses SqlCeConnection-Objekts mithilfe der angegebenen Zeichenfolge für den Schemanamen und des angegebenen Zeichenfolgenarrays für die Einschränkungswerte zurück. (Überschreibt DbConnection.GetSchema(String, array<String[]).)
	GetService	(von Component vererbt)
	GetType	(von Object vererbt)
	InitializeLifetimeService	(von MarshalByRefObject vererbt)
	MemberwiseClone()	(von Object vererbt)
	MemberwiseClone(Boolean)	(von MarshalByRefObject vererbt)
	OnStateChange	(von DbConnection vererbt)
	Open	Öffnet eine Datenbankverbindung mit den durch die ConnectionString-Eigenschaft angegebenen Eigenschafteneinstellungen. (Überschreibt DbConnection.Open().)
	ToString	(von Component vererbt)

Zum Anfang

Ereignisse

	Name	Beschreibung
	Disposed	(von Component vererbt)
	FlushFailure	Tritt auf, wenn das Wegschreiben im Hintergrund fehlschlägt.
	InfoMessage	Erfolgt, wenn der .NET Compact Framework-Datenanbieter für SQL Server eine Warn- oder Informationsmeldung sendet.
	StateChange	Tritt ein, wenn der Zustand der Verbindung geändert wird. (Überschreibt DbConnection.StateChange.)

Zum Anfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	IDbConnection.BeginTransaction()	(von DbConnection vererbt)
	IDbConnection.BeginTransaction(IsolationLevel)	(von DbConnection vererbt)
	IDbConnection.CreateCommand	(von DbConnection vererbt)

Zum Anfang

Hinweise

Ein SqlCeConnection-Objekt stellt eine eindeutige Verbindung mit einer Datenquelle dar. Wenn Sie eine Instanz von SqlCeConnection erstellen, werden alle Eigenschaften auf die Anfangswerte festgelegt. Eine Liste dieser Werte finden Sie unter dem SqlCeConnection-Konstruktor.

Wenn die SqlCeConnection-Klasse den Gültigkeitsbereich verlässt, wird sie nicht geschlossen. Sie müssen die Verbindung explizit schließen, indem Sie Close oder Dispose aufrufen.

SQL Server Compact unterstützt sowohl mehrere gleichzeitige Verbindungen als auch Verbindungen, die von mehreren Befehlen gleichzeitig verwendet werden. Daher können bei derselben Verbindung mehrere Instanzen von SqlCeDataReader geöffnet sein. Dieses Verhalten unterscheidet sich von dem des System.Data.SqlClient-Namespaces.

Wenn eine schwerwiegende SqlCeException-Ausnahme durch die Methode ausgelöst wird, die eine SqlCeCommand-Klasse ausführt, wird die SqlCeConnection-Klasse möglicherweise geschlossen. Sie können die Verbindung aber erneut öffnen und fortfahren.

Beispiele

Im folgenden Beispiel werden eine SqlCeCommand und eine SqlCeConnection erstellt. Die SqlCeConnection-Klasse wird geöffnet und als Connection-Eigenschaft für die SqlCeCommand-Klasse festgelegt. Anschließend wird die ExecuteNonQuery-Methode aufgerufen, und die Verbindung wird geschlossen.

Dim conn As SqlCeConnection = Nothing

Try
    conn = New SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')"

    cmd.ExecuteNonQuery()
Finally
    conn.Close()
End Try

SqlCeConnection conn = null;

try
{
    conn = new SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')";

    cmd.ExecuteNonQuery();
}
finally
{
    conn.Close();
}

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

SqlCeDataAdapter

SqlCeCommand