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. .gif "Hinweis") 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).