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
	SqlCeConnection()	Initialise une nouvelle instance de la classe SqlCeConnection.
	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
	CanRaiseEvents	(hérité de Component)
	ConnectionString	Obtient ou définit la chaîne utilisée pour ouvrir une base de données. (remplace DbConnection.ConnectionString.)
	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.)
	Container	(hérité de Component)
	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.)
	DatabaseIdentifier	Obtient l'identificateur unique de la base de données actuelle lors de la synchronisation.
	DataSource	Obtient le nom de fichier de la source de données. (remplace DbConnection.DataSource.)
	DbProviderFactory	(hérité de DbConnection)
	DesignMode	(hérité de Component)
	Events	(hérité de Component)
	ServerVersion	Retourne le numéro de version de la base de données sous forme de chaîne. (remplace DbConnection.ServerVersion.)
	Site	(hérité de Component)
	State	Obtient l'état actuel de la connexion. (remplace DbConnection.State.)

Haut de la page

Méthodes

	Nom	Description
	BeginDbTransaction	(hérité de DbConnection)
	BeginTransaction()	Commence une transaction de base de données.
	BeginTransaction(IsolationLevel)	Commence une transaction de base de données avec la valeur IsolationLevel actuelle.
	ChangeDatabase	Modifie la base de données active d'un SqlCeConnection ouvert. (remplace DbConnection.ChangeDatabase(String).)
	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().)
	CreateCommand	Crée et retourne un objet SqlCeCommand associé à SqlCeConnection.
	CreateDbCommand	(hérité de DbConnection)
	CreateObjRef	(hérité de MarshalByRefObject)
	Dispose()	Libère toutes les ressources utilisées par l'instance actuelle de la classe SqlCeConnection.
	Dispose(Boolean)	(hérité de Component)
	EnlistTransaction(Transaction)	(hérité de DbConnection)
	EnlistTransaction(Transaction)	Inscrit dans le Transaction spécifié.
	Equals	(hérité de Object)
	Finalize	(hérité de Component)
	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.
	GetHashCode	(hérité de Object)
	GetLifetimeService	(hérité de MarshalByRefObject)
	GetSchema()	Retourne les informations de schéma pour la source de données de ce SqlCeConnection. (remplace DbConnection.GetSchema().)
	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).)
	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[]).)
	GetService	(hérité de Component)
	GetType	(hérité de Object)
	InitializeLifetimeService	(hérité de MarshalByRefObject)
	MemberwiseClone()	(hérité de Object)
	MemberwiseClone(Boolean)	(hérité de MarshalByRefObject)
	OnStateChange	(hérité de DbConnection)
	Open	Ouvre une connexion de base de données avec les paramètres de propriété spécifiés par ConnectionString. (remplace DbConnection.Open().)
	ToString	(hérité de Component)

Haut de la page

Événements

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

Haut de la page

Implémentations d'interfaces explicites

	Nom	Description
	IDbConnection.BeginTransaction()	(hérité de DbConnection)
	IDbConnection.BeginTransaction(IsolationLevel)	(hérité de DbConnection)
	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