SqlCeConnection Class

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

Espace de noms: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (dans system.data.sqlserverce.dll)

Syntaxe

'Déclaration
Public NotInheritable Class SqlCeConnection
    Inherits DbConnection

public sealed class SqlCeConnection : DbConnection

public ref class SqlCeConnection sealed : public DbConnection

public final class SqlCeConnection extends DbConnection

public final class SqlCeConnection extends DbConnection

Remarques

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

SQL Server Compact 3.5 n'est actuellement pas optimisé pour servir de base de données pour les sites Web. Par défaut, les connexions à partir d'applications ASP.NET sont bloquées dans SQL Server Compact 3.5. SQL Server Compact 3.5 est optimisé pour être utilisé en tant que base de données incorporée dans des applications. L'utilisation de SQL Server Compact 3.5 en tant que base de données pour les sites Web requiert la prise en charge de plusieurs utilisateurs et des modifications simultanées de données. Cela peut entraîner des problèmes de performance. Par conséquent, ces scénarios ne sont pas pris en charge. D'autres éditions de SQL Server, y compris SQL Server Express, sont optimisées pour servir de base de données pour les sites Web.

SQL Server Compact 3.5 peut être utilisé avec ASP.NET dans des scénarios d'application dans lesquels ASP.NET est utilisé pour créer des bases de données SQL Server Compact 3.5 pour des scénarios de synchronisation. Utilisez le code suivant pour modifier le comportement par défaut de SQL Server Compact 3.5 afin de travailler avec ASP.NET.

AppDomain.CurrentDomain.SetData("SQLServerCompactEditionUnderWebHosting", true)

Hiérarchie d'héritage

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

Exemple

L'exemple suivant crée SqlCeCommand et 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 (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 Members
System.Data.SqlServerCe Namespace
SqlCeDataAdapter
SqlCeCommand Class