Méthode CompactDatabase (SQL Server Compact)
La méthode CompactDatabase récupère l'espace inutilisé dans la base de données SQL Server Compact 4.0 locale. Cette méthode permet également de modifier les paramètres du classement, du chiffrement et du mot de passe de la base de données.
Notes
Sauf si la chaîne de connexion de destination spécifie explicitement un mot de passe, la base de données obtenue ne sera pas chiffrée, que la source soit chiffrée ou non.
Syntaxe
object.CompactDatabase(SourceConnection, DestConnection)
Paramètres
Paramètre |
Description |
---|---|
SourceConnection |
Valeur de chaîne spécifiant une connexion à la base de données source à compacter Une erreur se produit si la base de données spécifiée par SourceConnection est déjà ouverte. |
DestConnection |
Valeur de chaîne spécifiant une connexion à la base de données de destination à créer par compactage Une erreur se produit si la base de données spécifiée par DestConnection existe déjà ou s'il existe un autre fichier du même nom. |
Exemple
HRESULT CompactDatabase(BSTR SourceConnection, BSTR DestConnection);
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 |
---|---|
Provider |
Indique le nom du fournisseur à utiliser pour la connexion à la source de données. Si cette propriété n'est pas spécifiée, le système considère que le fournisseur OLE DB de SQL Server Compact 4.0 est utilisé. Une erreur se produit si le nom du fournisseur dans la chaîne source diffère du nom du fournisseur dans la chaîne de destination. |
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. Locale Identifier 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 n'est pas chiffrée. 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. Si vous spécifiez un mot de passe vierge, la base de données n'est pas chiffrée. Le mot de passe de base de données peut contenir jusqu'à 40 caractères. |
SSCE:encryption mode or encryption mode |
Les valeurs pour cette propriété sont : engine default - ou - platform default La valeur par défaut est platform default. |
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: case sensitive |
Valeur booléenne qui détermine si la base de données respecte la casse. 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é est disponible à compter de la version SQL Server Compact 3.5 SP1. Pour plus d'informations, consultez Utilisation des classements (SQL Server Compact).
|
Les valeurs d'identificateur de paramètres régionaux sont prises en charge. Utilisez le LCID unique pour la valeur de Locale Identifier. Pour rechercher une liste de valeurs de LCID uniques, consultez Classements pris en charge (SQL Server Compact). Vous devez vérifier que les paramètres régionaux sont pris en charge sur l'appareil sur lequel vous créez la base de données.
Si vous ne spécifiez pas de valeur LCID lorsque vous créez la base de données, SQL Server Compact 4.0 utilise les paramètres régionaux système. Cela diffère des anciennes versions, dans lesquelles les paramètres régionaux anglais étaient systématiquement utilisés en l'absence d'indication de paramètres régionaux.
Important
Un arrêt anormal d'une application avant que l'opération Compact ne soit terminée laisse un fichier de base de données temporaire dans le système. Ce fichier se nomme <nom_fichier>pack.sdf et doit être supprimé manuellement.
Voir aussi
Référence
Propriété ErrorRecords (SQL Server Compact)