SqlCeConnection-Klasse
Stellt eine offene Verbindung mit einer Datenquelle dar.
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
public final class SqlCeConnection extends DbConnection
public final class SqlCeConnection extends DbConnection
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 Mobile 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.
Beispiel
Im folgenden Beispiel werden eine SqlCeCommand-Klasse und eine SqlCeConnection-Klasse erstellt. Die SqlCeConnection-Klasse wird geöffnet und als Connection-Eigenschaft für dieSqlCeCommand-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();
}
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Data.Common.DbConnection
System.Data.SqlServerCe.SqlCeConnection
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows CE, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows XP Professional x64 Edition, Windows XP SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
SqlCeConnection-Member
System.Data.SqlServerCe-Namespace
SqlCeDataAdapter
SqlCeCommand-Klasse