Propriété LocalConnectionString (RDA)
La propriété LocalConnectionString spécifie la chaîne de connexion OLE DB de la base de données SQL Server Compact 3.5 sur l'appareil basé sur Microsoft Windows CE.
Syntaxe
object.LocalConnectionString(value)
Application
Objet RDA de SQL Server Compact 3.5
Type de données
String
Modifiable
Lecture/écriture
Prototype
HRESULT get_LocalConnectionString(BSTR *pVal);
HRESULT put_LocalConnectionString(BSTR newVal);
Paramètres génériques
Paramètre |
Description |
|---|---|
value |
Chaîne de connexion OLE DB de la base de données SQL Server Compact 3.5. |
Notes
Le tableau suivant répertorie les noms de propriétés disponibles pour la chaîne de connexion OLE DB.
Propriété |
Description |
|---|---|
data source |
Chemin d'accès au fichier et nom de la base de données SQL Server Compact 3.5. Spécifiez le chemin d'accès absolu au fichier de base de données, plutôt qu'un chemin relatif. .gif "Remarque") Remarque
Une application exécutée sur un ordinateur de bureau ne peut pas établir de connexion de base de données à un fichier .sdf sur un appareil. De même, une application exécutée sur un appareil ne peut pas établir de connexion de base de données à un fichier .sdf sur un ordinateur de bureau.
|
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. Si vous spécifiez un mot de passe vierge, la base de données n'est pas chiffrée. |
ssce: encrypt database |
Valeur Boolean qui détermine si la base de données est chiffrée. Doit avoir la valeur true pour activer le chiffrement ou false pour ne pas l'activer. 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é. Si un mot de passe est spécifié, la base de données est chiffrée, même si SSCE:Encrypt Database n'est pas spécifié. Remarque
La propriété encrypt sera déconseillée dans une version ultérieure. La propriété est conservée dans SQL Server Compact 3.5 pour la compatibilité descendante.
|
ssce:encryption mode - ou - encryption mode |
Les valeurs de cette propriété sont engine default, platform default, ou ppc2003 compatibility.Le mode par défaut est platform default. |
ssce: max buffer size |
Quantité maximale de mémoire, en kilo-octets, que SQL Server Compact 3.5 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 escalade 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é de source de données du stockage temporaire. |
ssce: temp file max size |
Taille maximale du fichier de la 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. |
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é de connexion a été introduite dans SQL Server Compact 3.5 SP1.
|
Le tableau ci-après indique les valeurs possibles pour la propriété mode de la chaîne de connexion.
Valeur |
Définition |
|---|---|
Read Write |
Permet à plusieurs processus d'ouvrir et de modifier la base de données. Il s'agit de la valeur par défaut si la propriété du mode n'est pas spécifiée. |
Read Only |
Vous permet d'ouvrir une copie de la base de données en lecture seule. |
Exclusive |
Ne permet pas aux autres processus d'ouvrir ou de modifier la base de données. |
Shared Read |
Permet aux autres processus de lire la base de données alors qu'elle est ouverte, mais pas de la modifier. |
Les règles suivantes s'appliquent aux chaînes de connexion :
Tous les caractères vierges, à l'exception de ceux à l'intérieur d'une valeur ou entre guillemets doubles, sont ignorés.
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.
Aucune séquence d'échappement n'est prise en charge.
Le type de valeur n'est pas pertinent
Les noms ne respectent pas la casse.
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.
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 exemples suivants d'utilisation de guillemets à l'intérieur d'une chaîne de connexion sont valides :
"data source='MyDb.sdf'; ssce: mode=Exclusive;" 'data source="MyDb.sdf"; ssce: mode=Exclusive;'- En revanche, ces exemples ne sont pas valides :
"data source="MyDb.sdf"; ssce: mode=Exclusive;" 'data source='MyDb.sdf'; ssce: mode=Exclusive;'