CompactDatabase-Methode (SQL Server Compact)

Die CompactDatabase-Methode gibt in der lokalen SQL Server Compact 3.5-Datenbank Speicherplatz frei. Mit dieser Methode können außerdem die Einstellungen der Datenbank für Sortierreihenfolge, Verschlüsselung und Kennwort geändert werden.

Hinweis

Sofern die Zielverbindungszeichenfolge nicht ausdrücklich ein Kennwort angibt, wird die resultierende Datenbank nicht verschlüsselt, unabhängig davon, ob die Quelle verschlüsselt ist oder nicht.

Syntax

object.CompactDatabase(SourceConnection, DestConnection)

Parameter

Parameter	Beschreibung
SourceConnection	Ein Zeichenfolgenwert für eine Verbindung mit der zu komprimierenden Quelldatenbank. Ein Fehler tritt auf, wenn die mit SourceConnection angegebene Datenbank bereits geöffnet ist.
DestConnection	Ein Zeichenfolgenwert für eine Verbindung mit der Zieldatenbank, die bei der Komprimierung erstellt werden soll. Es tritt ein Fehler auf, wenn die von DestConnection angegebene Datenbank bzw. eine andere Datei unter diesem Dateinamen bereits vorhanden ist.

Beispiel

HRESULT CompactDatabase(BSTR SourceConnection, BSTR DestConnection);

Hinweise

Die Parameter SourceConnection und DestConnection geben die Eigenschaften der Quell- und Zieldatenbanken an. In der folgenden Tabelle sind die Verbindungseigenschaften aufgeführt, die Sie für jeden Parameter angeben können. Alle anderen Verbindungseigenschaften werden ignoriert.

Eigenschaft	Beschreibung
Provider	Zeigt den Namen des Anbieters an, der für die Verbindung mit der Datenquelle verwendet werden soll. Falls diese Eigenschaft nicht angegeben wird, wird der OLE DB-Anbieter für SQL Server Compact 3.5 verwendet. Ein Fehler tritt auf, wenn der Name des Anbieters in der Quellzeichenfolge vom Namen des Anbieters in der Zielzeichenfolge abweicht.
Data Source	Zeigt den Namen der Datenbank an. Diese Eigenschaft ist für die Verbindungsinformationen der Quelle und des Ziels erforderlich.
Locale Identifier	Gibt den Gebietsschemabezeichner (LCID) für die neue Datenbank an. Falls dieser Parameter nicht angegeben wird, hat die Zieldatenbank den gleichen LCID wie das Systemgebietsschema. Locale Identifier gibt die Sortierreihenfolge für Zeichenfolgenvergleiche in der Datenbank an.
SSCE:Database Password	Zeigt das Kennwort an, falls die Datenbank mit einem Kennwort gesichert ist. Das Kennwort für die Quelldatenbank muss angegeben werden, falls die Quelldatenbank ein Kennwort enthält. Falls dieser Parameter in der DestConnection -Zeichenfolge nicht angegeben wird, wird die neue Datenbank nicht verschlüsselt. Wenn Sie das Kennwort aus der Zieldatenbank entfernen möchten, muss für das Datenbankkennwort eine leere Zeichenfolge festgelegt werden. Wenn Sie ein leeres Kennwort angeben, wird die Datenbank nicht verschlüsselt. Für das Datenbankkennwort sind maximal 40 Zeichen zulässig.
SSCE:encryption mode or encryption mode	Die Werte für diese Eigenschaft lauten: engine default oder platform default oder ppc2003 compatibility Die Standardeinstellung ist platform default.
SSCE:Encrypt Database	Zeigt an, ob die neue Datenbank verschlüsselt werden soll. Falls der Parameter für die DestConnection -Zeichenfolge nicht angegeben wird, verwendet die neue Datenbank die gleiche Verschlüsselung wie die Quelldatenbank. Dies ist ein boolescher Wert und sollte mit Verschlüsselung auf TRUE bzw. ohne Verschlüsselung auf FALSE festgelegt werden. Hinweis: Wenn SSCE:Database Password angegeben wird, wird die Datenbank immer verschlüsselt, und zwar unabhängig davon, ob SSCE:Encrypt Database angeben wurde.
SSCE:Temp File Directory	Gibt den Speicherort der temporären Datenbank an. Wenn dieser Parameter in der DestConnection -Zeichenfolge nicht angegeben wird, wird der Speicherort der aktuellen Datenbank als Speicherort für die temporäre Datenbank verwendet.
ssce: case sensitive	Ein boolescher Wert, der festlegt, ob in der Datenbank die Groß-/Kleinschreibung berücksichtigt wird. Diese Eigenschaft muss auf true festgelegt werden, wenn die Groß-/Kleinschreibung berücksichtigt werden soll, oder auf false, wenn die Groß-/Kleinschreibung nicht berücksichtigt werden soll. Der Standardwert ist false. Hinweis: Diese Eigenschaft wurde mit der Version SQL Server Compact 3.5 SP1 eingeführt. Weitere Informationen finden Sie unter Arbeiten mit Sortierungen (SQL Server Compact).

Werte für Gebietsschemabezeichner werden unterstützt. Verwenden Sie den eindeutigen LCID für den Wert von Locale Identifier. Eine Liste mit eindeutigen LCID-Werten finden Sie unter Unterstützte Sortierungen (SQL Server Compact). Sie müssen sicherstellen, dass das Gebietsschema auf dem Gerät unterstützt wird, auf dem die Datenbank erstellt wird.

Falls Sie beim Erstellen der Datenbank keinen LCID-Wert angeben, verwendet SQL Server Compact 3.5 das Systemgebietsschema. Dies unterscheidet sich von früheren Versionen, bei denen immer das englische Gebietsschema verwendet wurde, falls kein Wert angegeben wurde.

Wichtig

Eine fehlerbedingte Beendigung einer Anwendung, bevor der Compact-Vorgang abgeschlossen ist, führt dazu, dass eine temporäre Datenbankdatei im System verbleibt. Diese Datei hat den Namen <filename>pack.sdf und muss manuell entfernt werden.

Siehe auch

Verweis

ErrorRecords-Eigenschaft (SQL Server Compact)

Andere Ressourcen

Programmierung mit dem Engine-Objekt (SQL Server Compact)

Hilfe und Informationen

Informationsquellen (SQL Server Compact 3.5 Service Pack 1)