Partager via


Classe SqlCeConnection

Représente une connexion ouverte à une source de données SQL Server Compact.

Hiérarchie d'héritage

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Data.Common.DbConnection
        System.Data.SqlServerCe.SqlCeConnection

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

Syntaxe

'Déclaration
Public NotInheritable Class SqlCeConnection _
    Inherits DbConnection
'Utilisation
Dim instance As SqlCeConnection
public sealed class SqlCeConnection : DbConnection
public ref class SqlCeConnection sealed : public DbConnection
[<SealedAttribute>]
type SqlCeConnection =  
    class
        inherit DbConnection
    end
public final class SqlCeConnection extends DbConnection

Le type SqlCeConnection expose les membres suivants.

Constructeurs

  Nom Description
Méthode publique SqlCeConnection() Initialise une nouvelle instance de la classe SqlCeConnection.
Méthode publique SqlCeConnection(String) Initialise une nouvelle instance de la classe SqlCeConnection avec la chaîne de connexion spécifiée.

Haut de la page

Propriétés

  Nom Description
Propriété protégée CanRaiseEvents (hérité de Component)
Propriété publique ConnectionString Obtient ou définit la chaîne utilisée pour ouvrir une base de données. (remplace DbConnection.ConnectionString.)
Propriété publique ConnectionTimeout Obtient la durée d'attente préalable à l'établissement d'une connexion avant que la tentative ne soit abandonnée et qu'une erreur ne soit générée. (remplace DbConnection.ConnectionTimeout.)
Propriété publique Container (hérité de Component)
Propriété publique Database Obtient le nom de la base de données en cours ou de la base de données à utiliser une fois la connexion ouverte. (remplace DbConnection.Database.)
Propriété publique DatabaseIdentifier Obtient l'identificateur unique de la base de données actuelle lors de la synchronisation.
Propriété publique DataSource Obtient le nom de fichier de la source de données. (remplace DbConnection.DataSource.)
Propriété protégée DbProviderFactory (hérité de DbConnection)
Propriété protégée DesignMode (hérité de Component)
Propriété protégée Events (hérité de Component)
Propriété publique ServerVersion Retourne le numéro de version de la base de données sous forme de chaîne. (remplace DbConnection.ServerVersion.)
Propriété publique Site (hérité de Component)
Propriété publique State Obtient l'état actuel de la connexion. (remplace DbConnection.State.)

Haut de la page

Méthodes

  Nom Description
Méthode protégée BeginDbTransaction (hérité de DbConnection)
Méthode publique BeginTransaction() Commence une transaction de base de données.
Méthode publique BeginTransaction(IsolationLevel) Commence une transaction de base de données avec la valeur IsolationLevel actuelle.
Méthode publique ChangeDatabase Modifie la base de données active d'un SqlCeConnection ouvert. (remplace DbConnection.ChangeDatabase(String).)
Méthode publique Close Ferme la connexion à la source de données. C'est la méthode recommandée de fermeture d'une connexion ouverte. (remplace DbConnection.Close().)
Méthode publique CreateCommand Crée et retourne un objet SqlCeCommand associé à SqlCeConnection.
Méthode protégée CreateDbCommand (hérité de DbConnection)
Méthode publique CreateObjRef (hérité de MarshalByRefObject)
Méthode publique Dispose() Libère toutes les ressources utilisées par l'instance actuelle de la classe SqlCeConnection.
Méthode protégée Dispose(Boolean) (hérité de Component)
Méthode publique EnlistTransaction(Transaction) (hérité de DbConnection)
Méthode publique EnlistTransaction(Transaction) Inscrit dans le Transaction spécifié.
Méthode publique Equals (hérité de Object)
Méthode protégée Finalize (hérité de Component)
Méthode publique GetDatabaseInfo Retourne un jeu de paires clé/valeur avec des informations relatives aux paramètres régionaux, au mode de chiffrement et au paramètre de respect de la casse de la base de données connectée.
Méthode publique GetHashCode (hérité de Object)
Méthode publique GetLifetimeService (hérité de MarshalByRefObject)
Méthode publique GetSchema() Retourne les informations de schéma pour la source de données de ce SqlCeConnection. (remplace DbConnection.GetSchema().)
Méthode publique GetSchema(String) Retourne les informations de schéma pour la source de données de ce SqlCeConnection en utilisant la chaîne spécifiée pour le nom du schéma. (remplace DbConnection.GetSchema(String).)
Méthode publique GetSchema(String, array<String[]) Retourne les informations de schéma pour la source de données de ce SqlCeConnection en utilisant la chaîne spécifiée pour le nom du schéma et le tableau de chaînes spécifié pour les valeurs de restriction. (remplace DbConnection.GetSchema(String, array<String[]).)
Méthode protégée GetService (hérité de Component)
Méthode publique GetType (hérité de Object)
Méthode publique InitializeLifetimeService (hérité de MarshalByRefObject)
Méthode protégée MemberwiseClone() (hérité de Object)
Méthode protégée MemberwiseClone(Boolean) (hérité de MarshalByRefObject)
Méthode protégée OnStateChange (hérité de DbConnection)
Méthode publique Open Ouvre une connexion de base de données avec les paramètres de propriété spécifiés par ConnectionString. (remplace DbConnection.Open().)
Méthode publique ToString (hérité de Component)

Haut de la page

Événements

  Nom Description
Événement public Disposed (hérité de Component)
Événement public FlushFailure Se produit lorsque le vidage d'arrière-plan échoue.
Événement public InfoMessage Se produit lorsque le fournisseur de données .NET Compact Framework pour SQL Server envoie un avertissement ou un message informatif.
Événement public StateChange Se produit lorsque l'état de la connexion change. (remplace DbConnection.StateChange.)

Haut de la page

Implémentations d'interfaces explicites

  Nom Description
Implémentation d'interface expliciteMéthode privée IDbConnection.BeginTransaction() (hérité de DbConnection)
Implémentation d'interface expliciteMéthode privée IDbConnection.BeginTransaction(IsolationLevel) (hérité de DbConnection)
Implémentation d'interface expliciteMéthode privée IDbConnection.CreateCommand (hérité de DbConnection)

Haut de la page

Notes

Un objet SqlCeConnection représente une connexion unique à une source de données. Lorsque vous créez une instance de SqlCeConnection, les valeurs initiales sont affectées à toutes les propriétés. Pour obtenir la liste de ces valeurs, consultez le constructeur SqlCeConnection.

Si SqlCeConnection est hors de portée, il n'est pas fermé. Vous devez fermer explicitement la connexion en appelant Close ou Dispose.

SQL Server Compact prend en charge plusieurs connexions simultanées aussi bien que plusieurs commandes qui partagent la même connexion. Cela signifie qu'il est possible d'avoir plusieurs instances de SqlCeDataReader ouvertes sur la même connexion. Ce comportement diffère de celui de System.Data.SqlClient.

Si un SqlCeException irrécupérable est généré par la méthode exécutant SqlCeCommand, SqlCeConnection peut être fermé. Vous pouvez toutefois rouvrir la connexion et continuer.

Exemples

L'exemple suivant crée un SqlCeCommand et un SqlCeConnection. SqlCeConnection est ouvert et défini en tant que Connection pour SqlCeCommand. L'exemple appelle ensuite ExecuteNonQuery et ferme la connexion.

Dim conn As SqlCeConnection = Nothing

Try
    conn = New SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'")
    conn.Open()

    Dim cmd As SqlCeCommand = conn.CreateCommand()
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')"

    cmd.ExecuteNonQuery()
Finally
    conn.Close()
End Try
SqlCeConnection conn = null;

try
{
    conn = new SqlCeConnection("Data Source = MyDatabase.sdf; Password ='<pwd>'");
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "INSERT INTO Customers ([Customer ID], [Company Name]) Values('NWIND', 'Northwind Traders')";

    cmd.ExecuteNonQuery();
}
finally
{
    conn.Close();
}

Sécurité des threads

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

Voir aussi

Référence

Espace de noms System.Data.SqlServerCe

SqlCeDataAdapter

SqlCeCommand