Version imprimable       Envoyer     
Cliquez pour évaluer et commenter
TechNet
Bibliothèque TechNet
SQL Server
SQL Server Compact 4.0
Référence technique de SQ...
Classe SqlCeConnection
Réduire tout/Développer tout Réduire tout
Cette page est spécifique à
Microsoft Visual Studio 2010/.NET Framework 4

D'autres versions sont également disponibles pour :
Classe SqlCeConnection

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

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)
Visual Basic (Déclaration)
Public NotInheritable Class SqlCeConnection _
    Inherits DbConnection
Visual Basic (Utilisation)
Dim instance As SqlCeConnection
C#
public sealed class SqlCeConnection : DbConnection
Visual C++
public ref class SqlCeConnection sealed : public DbConnection
F#
[<SealedAttribute>]
type SqlCeConnection =  
    class
        inherit DbConnection
    end
JScript
public final class SqlCeConnection extends DbConnection

Le type SqlCeConnection expose les membres suivants.

  NomDescription
Méthode publiqueSqlCeConnection()()()Initialise une nouvelle instance de la classe SqlCeConnection.
Méthode publiqueSqlCeConnection(String)Initialise une nouvelle instance de la classe SqlCeConnection avec la chaîne de connexion spécifiée.
Haut de la page
  NomDescription
Propriété protégéeCanRaiseEvents (hérité de Component)
Propriété publiqueConnectionStringObtient ou définit la chaîne utilisée pour ouvrir une base de données. (remplace DbConnection..::.ConnectionString.)
Propriété publiqueConnectionTimeoutObtient 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é publiqueContainer (hérité de Component)
Propriété publiqueDatabaseObtient 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é publiqueDatabaseIdentifierObtient l'identificateur unique de la base de données actuelle lors de la synchronisation.
Propriété publiqueDataSourceObtient le nom de fichier de la source de données. (remplace DbConnection..::.DataSource.)
Propriété protégéeDbProviderFactory (hérité de DbConnection)
Propriété protégéeDesignMode (hérité de Component)
Propriété protégéeEvents (hérité de Component)
Propriété publiqueServerVersionRetourne le numéro de version de la base de données sous forme de chaîne. (remplace DbConnection..::.ServerVersion.)
Propriété publiqueSite (hérité de Component)
Propriété publiqueStateObtient l'état actuel de la connexion. (remplace DbConnection..::.State.)
Haut de la page
  NomDescription
Méthode protégéeBeginDbTransaction (hérité de DbConnection)
Méthode publiqueBeginTransaction()()()Commence une transaction de base de données.
Méthode publiqueBeginTransaction(IsolationLevel)Commence une transaction de base de données avec la valeur IsolationLevel actuelle.
Méthode publiqueChangeDatabaseModifie la base de données active d'un SqlCeConnection ouvert. (remplace DbConnection..::.ChangeDatabase(String).)
Méthode publiqueCloseFerme 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 publiqueCreateCommandCrée et retourne un objet SqlCeCommand associé à SqlCeConnection.
Méthode protégéeCreateDbCommand (hérité de DbConnection)
Méthode publiqueCreateObjRef (hérité de MarshalByRefObject)
Méthode publiqueDispose()()()Libère toutes les ressources utilisées par l'instance actuelle de la classe SqlCeConnection.
Méthode protégéeDispose(Boolean) (hérité de Component)
Méthode publiqueEnlistTransaction(Transaction) (hérité de DbConnection)
Méthode publiqueEnlistTransaction(Transaction)Inscrit dans le Transaction spécifié.
Méthode publiqueEquals (hérité de Object)
Méthode protégéeFinalize (hérité de Component)
Méthode publiqueGetDatabaseInfoRetourne 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 publiqueGetHashCode (hérité de Object)
Méthode publiqueGetLifetimeService (hérité de MarshalByRefObject)
Méthode publiqueGetSchema()()()Retourne les informations de schéma pour la source de données de ce SqlCeConnection. (remplace DbConnection..::.GetSchema()()().)
Méthode publiqueGetSchema(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 publiqueGetSchema(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éeGetService (hérité de Component)
Méthode publiqueGetType (hérité de Object)
Méthode publiqueInitializeLifetimeService (hérité de MarshalByRefObject)
Méthode protégéeMemberwiseClone()()() (hérité de Object)
Méthode protégéeMemberwiseClone(Boolean) (hérité de MarshalByRefObject)
Méthode protégéeOnStateChange (hérité de DbConnection)
Méthode publiqueOpenOuvre une connexion de base de données avec les paramètres de propriété spécifiés par ConnectionString. (remplace DbConnection..::.Open()()().)
Méthode publiqueToString (hérité de Component)
Haut de la page
  NomDescription
Événement publicDisposed (hérité de Component)
Événement publicFlushFailureSe produit lorsque le vidage d'arrière-plan échoue.
Événement publicInfoMessageSe produit lorsque le fournisseur de données .NET Compact Framework pour SQL Server envoie un avertissement ou un message informatif.
Événement publicStateChangeSe produit lorsque l'état de la connexion change. (remplace DbConnection..::.StateChange.)
Haut de la page

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.

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.

Visual Basic
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
C#
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();
}
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.
© 2012 Microsoft. Tous droits réservés. Conditions d'utilisation | Marques | Confidentialité
Page view tracker