SqlCeConnection Clase

Artículo
01/17/2011

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
'Uso
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

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)

Ejemplos

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