SqlCeEngine-Klasse

  • Artikel

Stellt die Eigenschaften, Methoden und anderen Objekte des SQL Server Compact-Engine-Objekts dar. Diese Klasse kann nicht vererbt werden.

Vererbungshierarchie

System.Object
  System.Data.SqlServerCe.SqlCeEngine

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

Syntax

'Declaration
Public NotInheritable Class SqlCeEngine _
    Implements IDisposable
'Usage
Dim instance As SqlCeEngine

public sealed class SqlCeEngine : IDisposable

public ref class SqlCeEngine sealed : IDisposable

[<SealedAttribute>]
type SqlCeEngine =  
    class
        interface IDisposable
    end

public final class SqlCeEngine implements IDisposable

Der SqlCeEngine-Typ macht folgende Elemente verfügbar.

Konstruktoren

  Name Beschreibung
Öffentliche Methode SqlCeEngine() Initialisiert eine neue Instanz der SqlCeEngine-Klasse.
Öffentliche Methode SqlCeEngine(String) Initialisiert eine neue Instanz der SqlCeEngine-Klasse mit der angegebenen lokalen Verbindungszeichenfolge.

Zum Anfang

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft LocalConnectionString Ruft die Verbindungszeichenfolge für die SQL Server Compact-Datenbank ab oder legt diese fest.

Zum Anfang

Methoden

  Name Beschreibung
Öffentliche Methode Compact Nicht verwendeter Speicherplatz wird in der SQL Server Compact-Datenbank freigegeben, indem aus der vorhandenen Datei eine neue Datenbankdatei erstellt wird. Diese Methode wird auch verwendet, um die Sortierreihenfolge, die Verschlüsselung oder die Kennworteinstellungen der Datenbank zu ändern.
Öffentliche Methode CreateDatabase Erstellt eine neue Datenbank.
Öffentliche Methode Dispose Gibt alle SQL Server Compact SqlCeEngine-Ressourcen frei.
Öffentliche Methode Equals (von Object vererbt)
Geschützte Methode Finalize (von Object vererbt)
Öffentliche Methode GetHashCode (von Object vererbt)
Öffentliche Methode GetType (von Object vererbt)
Geschützte Methode MemberwiseClone (von Object vererbt)
Öffentliche Methode Repair Repariert eine beschädigte Datenbank.
Öffentliche Methode Shrink Nicht verwendeter Speicherplatz wird in der SQL Server Compact-Datenbank freigegeben, indem leere Seiten an das Ende der Datei verschoben werden und die Datei anschließend verkürzt wird.
Öffentliche Methode ToString (von Object vererbt)
Öffentliche Methode Upgrade() Aktualisiert eine SQL Server Compact-Datenbank von Version&nbsp;3.5 auf Version&nbsp;4.0. Nach dem Upgrade ist die Datenbank verschlüsselt, sofern die Quelldatenbank verschlüsselt war. Andernfalls ist die aktualisierte Datenbank unverschlüsselt.
Öffentliche Methode Upgrade(String) Aktualisiert eine SQL Server Compact-Datenbank von Version&nbsp;3.5 auf Version&nbsp;4.0. Die Zieldatenbank ist verschlüsselt, sofern der Verschlüsselungsmodus in der Zielverbindungs-Zeichenfolge festgelegt wurde. Bei der Sortierung der Datenbank wird die Groß-/Kleinschreibung berücksichtigt, wenn die Eigenschaft für die Unterscheidung nach Groß-/Kleinschreibung in der Verbindungszeichenfolge auf true festgelegt ist.
Öffentliche Methode Verify() Führt eine Neuberechnung der Prüfsumme für jede Seite in der Datenbank durch und vergleicht die neue Prüfsumme mit dem erwarteten Wert.
Öffentliche Methode Verify(VerifyOption) Überprüft die Integrität der Datenbank auf Grundlage von VerifyOption.

Zum Anfang

Hinweise

SQL Server Compact wurde optimiert, um als Datenbank für Websites und Webanwendungen zu dienen. SQL Server Compact wurde optimiert, um als eingebettete Datenbank in Webanwendungen zu dienen. SQL Server Compact kann als Datenbank für Websites für mehrere Benutzer und gleichzeitige Datenänderungen verwendet werden.

SQL Server Compact kann zum Entwickeln von ASP.NET-Webanwendungen verwendet werden. In den vorherigen Versionen von SQL Server Compact musste das Flag SQLServerCompactEditionUnderWebHosting festgelegt werden, um SQL Server Compact in ASP.NET-Webanwendungen verwenden zu können. Das Flag wurde in SQL Server Compact 4.0 entfernt.

Beispiele

Das folgende Beispiel veranschaulicht das Erstellen einer neuen SQL Server Compact-Datenbank.

If File.Exists("Test.sdf") Then
   File.Delete("Test.sdf")
End If 
Dim connStr As String = "Data Source = Test.sdf; Password = <password>"

Dim engine As New SqlCeEngine(connStr)
engine.CreateDatabase()
engine.Dispose()

Dim conn As SqlCeConnection = Nothing

Try
   conn = New SqlCeConnection(connStr)
   conn.Open()

   Dim cmd As SqlCeCommand = conn.CreateCommand()
   cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)"
   cmd.ExecuteNonQuery()
Catch
Finally
   conn.Close()
End Try

if (File.Exists("Test.sdf"))
    File.Delete("Test.sdf");

string connStr = "Data Source = Test.sdf; Password = <password>";

SqlCeEngine engine = new SqlCeEngine(connStr);
engine.CreateDatabase();
engine.Dispose();

SqlCeConnection conn = null;

try {
    conn = new SqlCeConnection(connStr);
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)";
    cmd.ExecuteNonQuery();
}
catch {}
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