Freigeben über


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
Öffentliche Methode SqlCeConnection() Initialisiert eine neue Instanz der SqlCeConnection-Klasse.
Öffentliche Methode SqlCeConnection(String) Initialisiert eine neue Instanz der SqlCeConnection-Klasse mit der angegebenen Verbindungszeichenfolge.

Zum Anfang

Eigenschaften

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

Zum Anfang

Methoden

  Name Beschreibung
Geschützte Methode BeginDbTransaction (von DbConnection vererbt)
Öffentliche Methode BeginTransaction() Beginnt eine Datenbanktransaktion.
Öffentliche Methode BeginTransaction(IsolationLevel) Beginnt eine Datenbanktransaktion mit dem aktuellen IsolationLevel-Wert.
Öffentliche Methode ChangeDatabase Wechselt die aktuelle Datenbank für ein geöffnetes SqlCeConnection-Element. (Überschreibt DbConnection.ChangeDatabase(String).)
Öffentliche Methode Close Schließt die Verbindung mit der Datenquelle. Dies ist die empfohlene Vorgehensweise zum Schließen offener Verbindungen. (Überschreibt DbConnection.Close().)
Öffentliche Methode CreateCommand Erstellt ein SqlCeCommand-Objekt, das der SqlCeConnection-Klasse zugeordnet ist, und gibt es zurück.
Geschützte Methode CreateDbCommand (von DbConnection vererbt)
Öffentliche Methode CreateObjRef (von MarshalByRefObject vererbt)
Öffentliche Methode Dispose() Gibt alle Ressourcen frei, die von der aktuellen Instanz der SqlCeConnection-Klasse verwendet werden.
Geschützte Methode Dispose(Boolean) (von Component vererbt)
Öffentliche Methode EnlistTransaction(Transaction) (von DbConnection vererbt)
Öffentliche Methode EnlistTransaction(Transaction) Nimmt einen Eintrag in der angegebenen Transaction vor.
Öffentliche Methode Equals (von Object vererbt)
Geschützte Methode Finalize (von Component vererbt)
Öffentliche Methode 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.
Öffentliche Methode GetHashCode (von Object vererbt)
Öffentliche Methode GetLifetimeService (von MarshalByRefObject vererbt)
Öffentliche Methode GetSchema() Gibt Schemainformationen für die Datenquelle dieses SqlCeConnection-Objekts zurück. (Überschreibt DbConnection.GetSchema().)
Öffentliche Methode 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).)
Öffentliche Methode 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[]).)
Geschützte Methode GetService (von Component vererbt)
Öffentliche Methode GetType (von Object vererbt)
Öffentliche Methode InitializeLifetimeService (von MarshalByRefObject vererbt)
Geschützte Methode MemberwiseClone() (von Object vererbt)
Geschützte Methode MemberwiseClone(Boolean) (von MarshalByRefObject vererbt)
Geschützte Methode OnStateChange (von DbConnection vererbt)
Öffentliche Methode Open Öffnet eine Datenbankverbindung mit den durch die ConnectionString-Eigenschaft angegebenen Eigenschafteneinstellungen. (Überschreibt DbConnection.Open().)
Öffentliche Methode ToString (von Component vererbt)

Zum Anfang

Ereignisse

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

Zum Anfang

Explizite Schnittstellenimplementierungen

  Name Beschreibung
Explizite SchnittstellenimplementierungPrivate Methode IDbConnection.BeginTransaction() (von DbConnection vererbt)
Explizite SchnittstellenimplementierungPrivate Methode IDbConnection.BeginTransaction(IsolationLevel) (von DbConnection vererbt)
Explizite SchnittstellenimplementierungPrivate Methode 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