Méthode CompactDatabase (SQL Server Compact Edition)

La méthode CompactDatabase récupère l'espace inutilisé dans la base de données SQL Server 2005 Compact Edition (SQL Server Compact Edition) 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

Prototype

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 Edition 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 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:Encrypt Database	Indique si la nouvelle base de données doit être chiffrée. Si ce paramètre est omis dans la chaîne DestConnection , la nouvelle base de données possède le même chiffrement que la base de données source. Il s'agit d'une valeur booléenne, qui doit être égale à TRUE pour l'application d'un chiffrement ou à FALSE pour l'absence de chiffrement. Remarque : Si SSCE:Database Password est spécifié, la base de données est toujours chiffrée, que SSCE:Encrypt Database soit spécifié ou non.
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.

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 COLLATE (SQL Server Compact Edition). 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 Edition 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 Edition)

Autres ressources

Programmation de l'objet Engine de SQL Server Compact Edition

Aide et information

Assistance sur SQL Server Compact Edition