Propriété SqlCeConnection.ConnectionString

Article
05/27/2011

Obtient ou définit la chaîne utilisée pour ouvrir une base de données.

Espace de noms : System.Data.SqlServerCe
Assembly : System.Data.SqlServerCe (en System.Data.SqlServerCe.dll)

Syntaxe

'Déclaration
Public Overrides Property ConnectionString As String
    Get
    Set
'Utilisation
Dim instance As SqlCeConnection
Dim value As String

value = instance.ConnectionString

instance.ConnectionString = value

public override string ConnectionString { get; set; }

public:
virtual property String^ ConnectionString {
    String^ get () override;
    void set (String^ value) override;
}

abstract ConnectionString : string with get, set
override ConnectionString : string with get, set

override function get ConnectionString () : String
override function set ConnectionString (value : String)

Valeur de propriété

Type : System.String
Chaîne de connexion du fournisseur de données .NET Compact Framework pour SQL Server Compact qui comprend le nom de la source de données, ainsi que d'autres paramètres nécessaires à l'établissement de la connexion initiale. La valeur par défaut est une chaîne vide.

Implémente

IDbConnection.ConnectionString

Exceptions

Exception	Condition
ArgumentException	Un argument de chaîne de connexion non valide a été fourni.

Notes

La propriété ConnectionString 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. Une fois la chaîne de connexion définie, toutes les propriétés sont mises à jour, sauf si une erreur est détectée. Dans ce cas, aucune propriété n'est mise à jour. Les propriétés SqlCeConnection retournent uniquement les paramètres contenus dans ConnectionString.

Si vous réinitialisez ConnectionString sur une connexion fermée, toutes les autres valeurs de chaîne de connexion et les propriétés qui leur sont associées sont réinitialisées, y compris le mot de passe.

Le tableau suivant énumère les propriétés ConnectionString prises en charge dans SQL Server Compact.

Propriété	Description
data source - ou - datasource	Chemin d'accès au fichier et nom de la base de données SQL Server Compact. Pour indiquer un chemin d'accès relatif à la base de données à partir du répertoire de l'application, utilisez la chaîne de substitution Data Source = \|DataDirectory\| (entre barres verticales). Utilisez la méthode SetData() sur l'objet AppDomain pour définir le répertoire de données de l'application. DataDirectory n'est pas pris en charge pour les périphériques. Pour plus d'informations, consultez Installation et déploiement sur un ordinateur de bureau (SQL Server Compact ).
Password - ou - Pwd - ou - database password - ou - ssce:database password	Mot de passe de la base de données, qui peut comporter 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 automatiquement activé sur la base de données. Si vous spécifiez un mot de passe vide, la base de données n'est pas chiffrée.
ssce:enlist ou enlist	La valeur par défaut est False. Elle peut prendre la valeur True. Si une connexion à la base de données SQL Server Compact est ouverte en utilisant Enlist avec la valeur True, la connexion est promue en transaction.
ssce:encryption mode ou encryption mode	Les valeurs pour cette propriété sont mode par défaut du moteur - ou - mode par défaut de la plateforme La valeur par défaut est le mode par défaut de la plateforme. Remarque Cette propriété est une option qui concerne le moment de la création de la base de données ; elle est ignorée lors de la connexion à une base de données existante.
Encrypt - ou -encrypt database - ou -ssce: encrypt database	Valeur booléenne qui détermine si la base de données est chiffrée ou non. Doit avoir la valeur true pour activer le chiffrement ou false pour ne pas l'activer. En l'absence de spécification, la valeur par défaut est false. Si vous activez le chiffrement, vous devez également spécifier un mot de passe avec la propriété password. Si vous spécifiez un mot de passe, le chiffrement est activé indépendamment de la définition de cette propriété. Remarque Cette propriété est une option qui concerne le moment de la création de la base de données ; elle est ignorée lors de la connexion à une base de données existante. Si un mot de passe SSCE:Database est spécifié, la base de données est toujours chiffrée, que SSCE:Encrypt Database soit spécifié ou non.
max buffer size - ou - ssce:max buffer size	Quantité de mémoire maximale, en kilo-octets, que SQL Server Compact peut utiliser avant de commencer à vider les modifications sur le disque. En l'absence de spécification, la valeur 640 est définie par défaut.
max database size - ou - ssce:max database size	Taille maximale de la base de données, en mégaoctets. En l'absence de spécification, la valeur 128 est définie par défaut.
Mode - ou - file mode - ou - ssce:mode	Mode à utiliser lors de l'ouverture du fichier de base de données. Pour connaître les valeurs valides, consultez le tableau qui suit. En l'absence de spécification, la valeur par défaut est 'Read Write'.
default lock timeout - ou - ssce: default lock timeout	Nombre par défaut de millisecondes pendant lesquelles une transaction attendra un verrou. En l'absence de spécification, la valeur 2000 est définie par défaut.
default lock escalation - ou - ssce:default lock escalation	Nombre de verrous qu'une transaction acquerra avant de tenter la remontée de ligne à page ou de page à table. En l'absence de spécification, la valeur 100 est définie par défaut.
flush interval - ou - ssce:flush interval	Spécifie l'intervalle de temps (en secondes) qui s'écoule avant que toutes les transactions validées ne soient vidées sur le disque. En l'absence de spécification, la valeur 10 est définie par défaut.
autoshrink threshold - ou - ssce:autoshrink threshold	Pourcentage d'espace libre dans le fichier de base de données qui est autorisé avant l'exécution d'Autoshrink. La valeur 100 désactive Autoshrink. En l'absence de spécification, la valeur 60 est définie par défaut.
temp path - ou - temp file directory - ou - ssce:temp file directory	Emplacement de la base de données temporaire. Si aucune valeur n'est spécifiée, la base de données spécifiée dans la propriété de la source de données pour le stockage temporaire est utilisée par défaut.
taille maximale du fichier temporaire	Taille maximale du fichier de base de données temporaire, en mégaoctets. En l'absence de spécification, la valeur 128 est définie par défaut.
persist security info	Lorsqu'elles ont la valeur false (vivement recommandée), les informations de sécurité, comme le mot de passe, ne sont pas retournées dans le cadre de la connexion si celle-ci est ouverte ou l'a été à un moment donné. La réinitialisation de la chaîne de connexion réinitialise toutes les valeurs des chaînes de connexion, y compris le mot de passe. La valeur par défaut est false.
locale identifier - ou - Lcid - ou - initial lcid	ID de paramètres régionaux (LCID) à utiliser avec la base de données. Les valeurs LCID valides sont répertoriées dans la classe CultureInfo. Remarque Cette propriété est une option qui concerne le moment de la création de la base de données ; elle est ignorée lors de la connexion à une base de données existante.
Case Sensitive - ou - CaseSensitive	Valeur booléenne qui détermine si le classement de la base de données respecte ou non la casse. Doit avoir la valeur true pour activer le classement avec respect de la casse ou false pour le classement sans respect de la casse. En l'absence de spécification, la valeur par défaut est false. Si vous vous connectez à une base de données SQL Server Compact existante avec une propriété « Case Sensitive » dans la chaîne de connexion, SQL Server Compact 3.5 SP1 ignore ce paramètre. Remarque Cette propriété est une option qui concerne le moment de la création de la base de données ; elle est ignorée lors de la connexion à une base de données existante.

Le tableau suivant répertorie les valeurs valides pour la propriété mode de la chaîne de connexion.

Valeur	Définition
Lecture/écriture	Permet à plusieurs processus d'ouvrir et de modifier la base de données. Il s'agit du paramètre par défaut si la propriété mode n'est pas spécifiée.
Lecture seule	Vous permet d'ouvrir une copie en lecture seule de la base de données.
Exclusif	N'autorise pas d'autres processus à ouvrir ou modifier la base de données.
Lecture partagée	Autorise d'autres processus à lire, mais pas à modifier, la base de données pendant qu'elle est ouverte.

Une validation préliminaire de la chaîne de connexion est exécutée si la propriété est définie. Lorsqu'une application appelle la méthode Open, la chaîne de connexion est complètement validée. Si la chaîne de connexion contient des propriétés non valides ou non prises en charge, une exception runtime, telle que ArgumentException, est générée à ce moment-là.

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

Tous les caractères vierges, excepté ceux placés au sein d'une valeur ou entre guillemets, sont ignorés.
Les paires mot clé/valeur 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 fois dans la chaîne de connexion, la valeur associée à la dernière occurrence est utilisée.
Les valeurs peuvent être délimitées par des guillemets simples ou doubles (par exemple, name='value' ou name="value"). Des guillemets simples ou doubles peuvent être utilisés à l'intérieur d'une chaîne de connexion en utilisant l'autre séparateur. Par exemple, les exemples suivants d'utilisation de guillemets à l'intérieur d'une chaîne de connexion sont valides :
```
"data source='MyDb.sdf'; mode=Exclusive;"
'data source="MyDb.sdf"; mode=Exclusive;'
```
En revanche, ces exemples ne sont pas valides :
```
"data source="MyDb.sdf"; mode=Exclusive;"
'data source='MyDb.sdf'; mode=Exclusive;'
```

Exemples

L'exemple suivant crée SqlCeConnection et définit certaines de ses propriétés dans la chaîne de connexion.

Dim conn As New SqlCeConnection()

' Set some connection string properties e.g.:
' 
conn.ConnectionString = _
    "Persist Security Info = False; Data Source = 'SalesData.sdf';" & _
    "Password = '<password>'; File Mode = 'shared read'; " & _
    "Max Database Size = 256; Max Buffer Size = 1024"

conn.Open()

' You can change the database while preserving 
' the orignal connection options
'
conn.ChangeDatabase("SupportData.sdf")

SqlCeConnection conn = new SqlCeConnection();

// Set some connection string properties e.g.:
// 
conn.ConnectionString = 
    "Persist Security Info = False; Data Source = 'SalesData.sdf';" +
    "Password = '<password>'; File Mode = 'shared read'; " +
    "Max Database Size = 256; Max Buffer Size = 1024";

conn.Open();

// You can change the database while preserving 
// the orignal connection options
//
conn.ChangeDatabase("SupportData.sdf");