SqlCeConnection Class

Representa una conexión abierta a un origen de datos de SQL Server Compact 3.5.

Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en system.data.sqlserverce.dll)

Sintaxis

'Declaración
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

Notas

Objeto SqlCeConnection que representa una conexión exclusiva a un origen de datos. Cuando se crea una instancia de SqlCeConnection, se establecen todas las propiedades en sus valores iniciales. Para obtener una lista de esos valores, vea el constructor de SqlCeConnection.

Si la conexión SqlCeConnection está fuera de ámbito, no se cierra. Debe cerrar la conexión de forma explícita mediante una llamada a Close o a Dispose.

SQL Server Compact 3.5 admite varias conexiones simultáneas, así como varios comandos que compartan la misma conexión. Esto significa que puede tener varias instancias de SqlCeDataReader abiertas en la misma conexión. Este comportamiento difiere del de System.Data.SqlClient.

Si el método que ejecuta SqlCeCommand genera una SqlCeException grave, SqlCeConnection podría cerrarse. El usuario puede volver a abrir la conexión y continuar.

SQL Server Compact 3.5 no está optimizado actualmente con el fin de servir de base de datos para sitios web. De forma predeterminada, las conexiones de las aplicaciones conectadas por ASP.NET se bloquean en SQL Server Compact 3.5. SQL Server Compact 3.5 está optimizado para su uso como base de datos incrustada en las aplicaciones. El uso de SQL Server Compact 3.5 como base de datos de sitios web requiere compatibilidad con varios usuarios y cambios de datos simultáneos. De esta forma, se pueden producir problemas de rendimiento. Por lo tanto, no se admiten estos escenarios. Otras ediciones de SQL Server, incluido SQL Server Express, se han optimizado para servir de base de datos de sitios web.

SQL Server Compact 3.5 se puede utilizar con ASP.NET en escenarios de aplicación donde ASP.NET se utiliza con el fin de crear bases de datos de SQL Server Compact 3.5 para escenarios de sincronización. Utilice el código siguiente para cambiar el comportamiento predeterminado de SQL Server Compact 3.5 para trabajar en ASP.NET.

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

Jerarquía de herencia

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

Ejemplo

En el siguiente ejemplo se crean SqlCeCommand y SqlCeConnection. Se abre SqlCeConnection y se establece como Connection para SqlCeCommand. A continuación, en el ejemplo se llama a ExecuteNonQuery y se cierra la conexión.

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();
}

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

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
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeConnection Members
System.Data.SqlServerCe Namespace
SqlCeDataAdapter
SqlCeCommand Class