ISSCEEngine.UpgradeDatabase (SQL Server Compact)

Die ISSCEEngine.Upgrade-Methode aktualisiert eine SQL Server Compact-Datenbank von Version 3.5 auf Version 4.0. Wenn die Quelldatenbank verschlüsselt ist, wird auch die aktualisierte Datenbank verschlüsselt sein. Die aktualisierte Datenbank wird unverschlüsselt sein, wenn Sie nicht ausdrücklich ein Kennwort in der Zielzeichenfolge bereitstellen.

Syntax

object.UpgradeDatabase(SourceConnection, DestConnection)

Parameter

Parameter	Beschreibung
SourceConnection	Ein Zeichenfolgenwert, der eine Verbindung zur Quelldatenbank angibt (die zu aktualisierende Datenbank). Ein Fehler tritt auf, wenn die mit SourceConnection angegebene Datenbank bereits geöffnet ist.
DestConnection (Optional)	Ein Zeichenfolgenwert, der eine Verbindung zur Zieldatenbank angibt, wenn eine andere Datei, die denselben Namen verwendet, vorhanden ist. Wenn DestConnection mit dem Wert NULL übergeben wird, werden erforderliche Eigenschaften wie LCID und Password von der Quelldatei abgeleitet.

Rückgabewert

Der Rückgabetyp ist HRESULT, und S_OK wird bei Erfolg zurückgegeben.

Prototyp

HRESULT UpgradeDatabase(BSTR SourceConnection, BSTR DestConnection);

Um die Datenbankdatei von SQL Server Compact Version 3.1 auf Version 3.5 zu aktualisieren, ohne eine neue Datei zu erstellen, übergeben Sie dieselbe Datenquelleneigenschaft sowohl in der Quell- als auch der Zielverbindungszeichenfolge.

Hinweise

Die Parameter SourceConnection und DestConnection geben die Eigenschaften der Quell- und der Zieldatenbank 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
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. LCID 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. Wenn dieser Parameter in der 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: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:Encryption Mode	Gibt den Zielverschlüsselungsmodus an. Wird kein Wert angegeben, wird Platform Default verwendet.
SSCE:Case Sensitive	Legt fest, ob für die Datenbank die Groß-/Kleinschreibung berücksichtigt wird oder nicht. 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 false, wenn keine Option angegeben wird. Hinweis Diese Verbindungseigenschaft wurde in SQL Server Compact SP1 eingeführt.

Eine Liste mit eindeutigen LCID-Werten finden Sie unter Unterstützte Sortierungen (SQL Server Compact). Vergewissern Sie sich, dass das Gebietsschema in der Anwendung unterstützt wird, in der die Datenbank erstellt wird.

Eine Liste der verschiedenen gültigen Verschlüsselungsmodi finden Sie unter Aktualisieren von früheren Versionen (SQL Server Compact).