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