CompactDatabase-Methode (SQL Server Compact Edition)
Die CompactDatabase-Methode gibt in der lokalen Datenbank für SQL Server 2005 Compact Edition (SQL Server Compact Edition) Speicherplatz frei. Mit dieser Methode können außerdem die Einstellungen der Datenbank für Sortierreihenfolge, Verschlüsselung und Kennwort geändert werden.
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. |
Prototyp
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 Edition 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 für die DestConnection -Zeichenfolge nicht angegeben wird, hat die neue Datenbank das gleiche Datenbankkennwort wie die Quelldatenbank. Wenn Sie das Kennwort aus der Zieldatenbank entfernen möchten, muss für das Datenbankkennwort eine leere Zeichenfolge festgelegt werden. Für das Datenbankkennwort sind maximal 40 Zeichen zulässig. |
||
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.
|
||
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. |
.gif)
Hinweis: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 COLLATE (SQL Server Compact Edition). 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 Edition das Systemgebietsschema. Dies unterscheidet sich von früheren Versionen, bei denen immer das englische Gebietsschema verwendet wurde, falls kein Wert angegeben wurde.
Siehe auch
Referenz
ErrorRecords-Eigenschaft (SQL Server Compact Edition)
Sonstige Ressourcen
Programmierung mit dem Engine-Objekt von SQL Server Compact Edition