Partager via

SqlCeConnection.ConnectionString Property

  • Article

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 (dans system.data.sqlserverce.dll)

Syntaxe

'Déclaration
Public Overrides Property ConnectionString As String

public override string ConnectionString { get; set; }

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

/** @property */
public String get_ConnectionString ()

/** @property */
public void set_ConnectionString (String value)

public override function get ConnectionString () : String

public override function set ConnectionString (value : String)

Valeur de propriété

Chaîne de connexion du fournisseur de données .NET Compact Framework pour SQL Server Compact 3.5 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.

Exceptions

Type d'exception Condition
ArgumentException

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

Remarques

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 3.5.

Propriété

Description

data source - ou - datasource

Chemin d'accès au fichier et nom de la base de données SQL Server Compact 3.5. 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. En l'absence de spécification, la valeur par défaut est aucun 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 3.5 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

ou

compatibilité ppc2003

La valeur par défaut est le mode par défaut de la plateforme.

ew0d66d7.note(fr-fr,VS.90).gifRemarque :
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é.

ew0d66d7.note(fr-fr,VS.90).gifRemarque :
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 3.5 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.

ew0d66d7.note(fr-fr,VS.90).gifRemarque :
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.

ew0d66d7.note(fr-fr,VS.90).gifRemarque :
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 :

  1. Tous les caractères vierges, excepté ceux placés au sein d'une valeur ou entre guillemets, sont ignorés.

  2. 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 également être délimité par des guillemets.

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

  4. Le type valeur est sans importance.

  5. Les noms ne respectent pas la casse.

  6. 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.

  7. 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;'

Exemple

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");

Sécurité des threads

Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme sûrs.

Plateformes

Plateformes de développement

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Informations sur la version
.NET Framework et NET Compact Framework
Pris en charge dans 3.5
.NET Framework
Pris en charge dans 3.0
.NET Compact Framework et .Net Framework
Pris en charge dans 2.0

Voir aussi

Référence

SqlCeConnection Class
SqlCeConnection Members
System.Data.SqlServerCe Namespace

Autres ressources

Mise à niveau à partir de versions antérieures (SQL Server Compact)