SqlCeConnection Clase
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();
}
Jerarquía de herencia
System. . :: . .Object
System. . :: . .MarshalByRefObject
System.ComponentModel. . :: . .Component
System.Data.Common. . :: . .DbConnection
System.Data.SqlServerCe..::..SqlCeConnection
Seguridad para subprocesos
Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.