ISSCEEngine.UpgradeDatabase (SQL Server Compact)

La méthode ISSCEEngine.Upgrade met à niveau une base de données SQL Server Compact de la version 3.5 à la version 4.0. Si la base de données source est chiffrée, la base de données mise à niveau sera chiffrée aussi. La base de données mise à niveau ne sera pas chiffrée sauf si vous fournissez explicitement un mot de passe dans la chaîne de destination.

Syntaxe

object.UpgradeDatabase(SourceConnection, DestConnection)

Paramètres

Paramètre	Description
SourceConnection	Valeur de chaîne spécifiant une connexion à la base de données (base de données à mettre à niveau). Une erreur se produit si la base de données spécifiée par SourceConnection est déjà ouverte.
DestConnection (Facultatif)	Valeur de chaîne qui spécifie une connexion à la base de données de destination si un autre fichier utilisant le même nom existe. Si DestConnection est passée comme null, les propriétés requises telles que LCID et Password sont dérivées du fichier source.

Valeur de retour

Le type retourné est HRESULT et S_OK est retournée en cas de réussite.

Prototype

HRESULT UpgradeDatabase(BSTR SourceConnection, BSTR DestConnection);

Pour mettre à niveau le fichier de la base de données de SQL Server Compact version 3.1 vers la version 3.5 sans créer de nouveau fichier, passez la même propriété de source de données dans les chaînes de connexion source et de destination.

Notes

Les paramètres SourceConnection et DestConnection spécifient les propriétés des bases de données source et de destination. Le tableau ci-après répertorie les propriétés de connexion que vous pouvez spécifier pour chaque paramètre. Toutes les autres propriétés de connexion sont ignorées.

Propriété	Description
Data Source	Indique le nom de la base de données. Cette propriété est requise pour les informations de connexion source et de destination.
Locale Identifier	Indique l'identificateur de paramètres régionaux (LCID) de la nouvelle base de données. S'il est omis, la base de données de destination possède le même LCID que les paramètres régionaux système. Le LCID spécifie l'ordre de classement des comparaisons de chaîne dans la base de données.
SSCE:Database Password	Indique le mot de passe, si la base de données est sécurisée par un mot de passe. Le mot de passe de base de données source doit être fourni si la base de données source contient un mot de passe. Si ce paramètre est omis dans la chaîne DestConnection, la nouvelle base de données possède le même mot de passe de base de données que la base de données source. Si vous souhaitez supprimer le mot de passe de la base de données de destination, vous devez attribuer une chaîne vide au mot de passe de base de données. Le mot de passe de base de données peut contenir jusqu'à 40 caractères.
SSCE:Temp File Directory	Spécifie l'emplacement de la base de données temporaire. Si ce paramètre est omis dans la chaîne DestConnection, l'emplacement de la base de données active est utilisé en guise d'emplacement de la base de données temporaire.
SSCE:Encryption Mode	Spécifie le mode de chiffrement de destination. En l'absence de spécification, il utilise Platform Default.
SSCE:Case Sensitive	Spécifie si la base de données respecte la casse ou non. Vous devez lui attribuer la valeur True pour activer le respect de la casse ou False pour indiquer le non-respect de la casse. Si elle n'est pas spécifiée, la valeur par défaut est False. Remarque Cette propriété de connexion a été introduite dans SQL Server Compact SP1.

Pour rechercher une liste de valeurs de LCID uniques, consultez Classements pris en charge (SQL Server Compact). Vérifiez que les paramètres régionaux sont pris en charge sur l'application sur laquelle vous créez la base de données.

Pour la liste des différents modes de chiffrement valides, consultez Mise à niveau à partir de versions antérieures (SQL Server Compact).