Propriété LocalConnectionString (SQL Server Compact Edition)

Fournit la chaîne de connexion de la base de données Microsoft SQL Server 2005 Compact Edition (SQL Server Compact Edition) locale.

Syntaxe

object.LocalConnectionString

Propriétés

Modifiable

Lecture seule

Notes

La propriété LocalConnectionString ne peut être définie que lorsque la connexion est fermée. De nombreuses valeurs de chaîne de connexion possèdent des propriétés en lecture seule correspondantes. Lorsque la chaîne de connexion est définie, toutes ces propriétés sont mises à jour, sauf si une erreur est détectée. Dans ce cas, aucune des propriétés n'est mise à jour.

La redéfinition de la propriété LocalConnectionString sur une connexion fermée réinitialise l'ensemble des valeurs de chaîne de connexion et des propriétés connexes, notamment le mot de passe.

Le tableau ci-dessous répertorie les propriétés LocalConnectionString prises en charge dans SQL Server Compact Edition.

Propriété	Description
data source	Chemin d'accès au fichier et nom de la base de données SQL Server Compact Edition Remarque : Vous devez spécifier le chemin d'accès absolu au fichier de base de données, au lieu du chemin relatif.
ssce: database password	Mot de passe de la base de données, qui peut contenir jusqu'à 40 caractères. S'il n'est pas spécifié, la valeur par défaut correspond à l'absence de mot de passe. Cette propriété est requise si vous activez le chiffrement sur la base de données. Si vous spécifiez un mot de passe, le chiffrement est activé sur la base de données.
ssce: encrypt database	Valeur booléenne qui détermine si la base de données est chiffrée. Vous devez lui attribuer la valeur true pour activer le chiffrement, ou false pour indiquer l'absence de chiffrement. Si elle n'est pas spécifiée, la valeur par défaut est false. Si vous activez le chiffrement, vous devez également spécifier un mot de passe à l'aide de la propriété de mot de passe. Si vous spécifiez un mot de passe, le chiffrement est activé quelle que soit la valeur que vous attribuez à cette propriété.
ssce: max buffer size	Quantité maximale de mémoire, en kilo-octets, que SQL Server Compact Edition peut utiliser avant de commencer à vider les modifications vers le disque. Si elle n'est pas spécifiée, la valeur par défaut est 640.
ssce: max database size	Taille maximale de la base de données, en mégaoctets. Si elle n'est pas spécifiée, la valeur par défaut est 128.
ssce:mode	Mode à utiliser lorsque vous ouvrez le fichier de base de données. Le tableau ci-après répertorie les valeurs possibles. S'il n'est pas spécifié, la valeur par défaut est Read/Write.
ssce: default lock timeout	Durée par défaut, en millisecondes, pendant laquelle une transaction attend un verrou. Si elle n'est pas spécifiée, la valeur par défaut est 2000.
ssce: default lock escalation	Nombre de verrous acquis par une transaction avant que vous tentiez une promotion d'une ligne vers une page ou d'une page vers une table. S'il n'est pas spécifié, la valeur par défaut est 100.
ssce: flush interval	Délai au terme duquel toutes les transactions validées sont vidées vers le disque. S'il n'est pas spécifié, la valeur par défaut est 10.
ssce: autoshrink threshold	Pourcentage d'espace disponible autorisé dans le fichier de base de données avant le démarrage de la réduction automatique. La valeur 100 désactive la réduction automatique. S'il n'est pas spécifié, la valeur par défaut est 60.
ssce: temp file directory	Emplacement de la base de données temporaire. S'il n'est pas spécifié, la procédure par défaut consiste à utiliser la base de données indiquée dans la propriété source de données du stockage temporaire.
ssce: temp file max size	Taille maximale du fichier de base de données temporaire, en mégaoctets. Si elle n'est pas spécifiée, la valeur par défaut est 128.
locale identifier	Identificateur de paramètres régionaux (LCID) à utiliser avec la base de données.

Le tableau ci-après indique les valeurs possibles pour la propriété du mode de la chaîne de connexion.

Les règles suivantes s'appliquent aux chaînes de connexion :

1. Tous les caractères vierges, à l'exception de ceux à l'intérieur d'une valeur ou entre guillemets doubles, sont ignorés.

2. Les paires de valeurs de mot clé doivent être séparées par un point-virgule (;). Si un point-virgule fait partie d'une valeur, il doit être délimité par des guillemets.

3. Aucune séquence d'échappement n'est prise en charge.

4. Le type de valeur n'est pas pertinent

5. Les noms ne respectent pas la casse.

6. Si un nom de propriété apparaît à plusieurs reprises dans la chaîne de connexion, c'est la valeur associée à la dernière occurrence qui est utilisée.

7. Les valeurs peuvent être délimitées par des guillemets simples ou doubles, par exemple name='valeur' ou name="valeur". Vous pouvez employer des guillemets simples (ou doubles) dans une chaîne de connexion, à condition d'utiliser des guillemets doubles (ou simples) en guise de délimiteurs. Par exemple, les utilisations de guillemets suivantes dans une chaîne de connexion sont correctes :

   "data source='MyDb.sdf'; ssce: mode=Exclusive;"
   'data source="MyDb.sdf"; ssce: mode=Exclusive;'
   But these examples are not valid:
   "data source="MyDb.sdf"; ssce: mode=Exclusive;"
   'data source='MyDb.sdf'; ssce: mode=Exclusive;'
   

Voir aussi

Référence

Objet SSCEError
Méthode CompactDatabase (SQL Server Compact Edition)
Collection SSCEErrors

Aide et information

Assistance sur SQL Server Compact Edition