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.

Syntaxe

object.CompactDatabase(SourceConnection, DestConnection)

Paramètres

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.

Voir aussi

Référence

Propriété ErrorRecords (SQL Server Compact)

Autres ressources

Programmation de l'objet Engine (SQL Server Compact)