Crear aplicaciones para escritorios (SQL Server Compact)

Artículo
01/17/2011

Puede usar SQL Server Compact 3.5 como almacén de datos para aplicaciones de PC. En este tema aprenderá a agregar SQL Server Compact 3.5 a un producto Visual Studio y, a continuación, aprenderá a crear código para el espacio de nombres System.Data.SqlServerCe. En la documentación de referencia de .NET Framework hay temas de referencia para el espacio de nombres System.Data.SqlServerCe.

Crear un proyecto de PC

Para crear una nueva aplicación de PC, primero debe crear un proyecto de Windows en Visual Studio. Para una aplicación de PC, deberá agregar una referencia al espacio de nombres Microsoft.Ink.

Nota

Si desarrolla la aplicación para Tablet PC en un equipo que no tiene Windows XP Tablet PC Edition, primero deberá instalar el kit de desarrollo de Microsoft Windows XP Tablet PC Edition. Puede descargar la última versión desde Mobile and Embedded Application Developer Center.

Para crear un nuevo proyecto de PC

En Visual Studio, en el menú Archivo, seleccione Nuevo y, a continuación, seleccione Proyecto.
En la lista Plantillas instaladas del cuadro de diálogo Nuevo proyecto, expanda el lenguaje de programación que desee usar y, a continuación, seleccione Windows.
En la lista Plantillas, seleccione Aplicación de Windows Forms.
Escriba un nombre y ubicación para el proyecto y, a continuación, haga clic en Aceptar.

Visual Studio crea un nuevo proyecto y muestra el formulario principal (Form1).
En el Explorador de soluciones, haga clic con el botón secundario en Referencias y seleccione Agregar referencia (opcional).

Nota

Si la carpeta Referencias no aparece en el Explorador de soluciones, haga clic en Mostrar todos los archivos en la parte superior del Explorador de soluciones.
En la lista de ensamblados .NET, seleccione API de Microsoft Tablet PC y haga clic en Aceptar (opcional).

La lista de referencias incluirá ahora Microsoft.Ink.

Agregar SQL Server Compact 3.5 al proyecto cuando se crea una aplicación para la implementación central

Una vez creado el proyecto, debe agregar una referencia al ensamblado de SQL Server Compact 3.5. Los procedimientos para agregar referencias a los ensamblados de SQL Server Compact 3.5 cuando se crea una aplicación para la implementación privada o para la implementación central de SQL Server Compact 3.5 son ligeramente diferentes. Siga estos pasos para la implementación central.

Para agregar una referencia a SQL Server Compact 3.5 para la implementación central

En Explorador de soluciones, haga clic con el botón secundario en Referencias y seleccione Agregar referencia.

Nota

Si la carpeta Referencias no aparece en el Explorador de soluciones, haga clic en Mostrar todos los archivos en la parte superior del Explorador de soluciones.
En la lista de ensamblados de .NET, seleccione System.Data.SqlServerCe y haga clic en Aceptar. Si System.Data.SqlServerCe no aparece, siga estos pasos:
1. En el cuadro de diálogo Agregar referencias, haga clic en Examinar.
2. Navegue hasta la siguiente carpeta: %Program Files%\Microsoft SQL Server Compact Edition\v3.5\Desktop.
3. Seleccione System.Data.SqlServerCe.dll y, a continuación, haga clic en Aceptar.
La lista de referencias del Explorador de soluciones incluye ahora System.Data.SqlServerCe y su proyecto puede utilizar este ensamblado.

Nota

Si su proyecto utiliza Entity Framework, repita los mismos pasos para agregar una referencia a System.Data.SqlServerCe.Entity. Puede agregar System.Data.SqlServerCe.Entity desde la lista de ensamblados de .NET o puede desplazarse hasta %Program Files%\Microsoft SQL Server Compact Edition\v3.5.
En el Explorador de soluciones, haga clic con el botón secundario en Form1.cs o en Form1.vb y seleccione Ver código.
En la parte superior del código para el formulario, agregue una directiva para utilizar el espacio de nombres System.Data.SqlServerCe. Si utiliza Entity Framework, agregue una directiva para utilizar el espacio de nombres System.Data.SqlServerCe. En el caso de una aplicación para Tablet PC, también debe agregar una directiva para usar la API de Tablet PC:
- C#
```
using System.Data.SqlServerCe;
using System.Data.SqlServerCe.Entity; 
using Microsoft.Ink;
```
- Visual Basic
```
Imports System.Data.SqlServerCe
Imports System.Data.SqlServerCe.Entity
Imports Microsoft.Ink
```

Agregar SQL Server Compact 3.5 al proyecto cuando se crea una aplicación para la implementación privada

Para agregar una referencia a SQL Server Compact 3.5 para la implementación privada

En Explorador de soluciones, haga clic con el botón secundario en Referencias y seleccione Agregar referencia.

Nota

Si la carpeta Referencias no aparece en el Explorador de soluciones, haga clic en Mostrar todos los archivos en la parte superior del Explorador de soluciones.
En el cuadro de diálogo Agregar referencias, haga clic en Examinar.
Navegue hasta la carpeta %Program Files%\Microsoft SQL Server Compact Edition\v3.5\Private.
Seleccione System.Data.SqlServerCe y, a continuación, haga clic en Aceptar.

La lista de referencias del Explorador de soluciones incluye ahora System.Data.SqlServerCe y su proyecto puede utilizar este ensamblado.

Nota

Si su proyecto utiliza Entity Framework, repita los mismos pasos para agregar una referencia a System.Data.SqlServerCe.Entity. (Para la implementación privada, System.Data.SqlServerCe.Entity se agrega también desde la carpeta %Program Files%\Microsoft SQL Server Compact Edition\v3.5\Private).
En el Explorador de soluciones, haga clic con el botón secundario en Form1.cs o en Form1.vb y seleccione Ver código.
En la parte superior del código para el formulario, agregue una directiva para utilizar el espacio de nombres System.Data.SqlServerCe. Si utiliza Entity Framework, agregue una directiva para utilizar el espacio de nombres System.Data.SqlServerCe. En el caso de una aplicación para Tablet PC, también debe agregar una directiva para usar la API de Tablet PC:
- C#
```
using System.Data.SqlServerCe;
using System.Data.SqlServerCe.Entity; 
using Microsoft.Ink;
```
- Visual Basic
```
Imports System.Data.SqlServerCe
Imports System.Data.SqlServerCe.Entity
Imports Microsoft.Ink
```

Configurar SQL Server Compact para la implementación privada

Para crear una aplicación que utilice la implementación privada de SQL Server Compact 3.5, debe asegurarse de que el proveedor de datos de .NET Framework y todas las DLL nativas necesarias se implementan en el directorio de salida de la aplicación. Si desea que su aplicación utilice la implementación privada de SQL Server Compact 3.5, siga los pasos de esta sección. Si la aplicación no utiliza la implementación privada, omita esta sección. Para obtener más información sobre la implementación privada de SQL Server Compact 3.5, vea Comparación de la implementación privada y la implementación central (SQL Server Compact). En los siguientes pasos se presupone que la aplicación se va a crear para cualquier plataforma (de 32 bits y de 64 bits). Si el destino de la aplicación es una sola de estas plataformas, puede omitir los pasos que se aplican a la otra plataforma.

Para configurar la aplicación para la implementación privada de SQL Server Compact

Configure el proveedor de datos de .NET Framework para el ensamblado de SQL Server Compact 3.5 que se va a copiar en el directorio de salida cuando se genere el proyecto.
1. En Explorador de soluciones, expanda Referencias, haga clic con el botón secundario en System.Data.SqlServerCe y seleccione Propiedades.
2. En Propiedades de referencia de System.Data.SqlServerCe, establezca Copia local en True.
Nota

Si el proyecto utiliza Entity Framework, repita los mismos pasos para System.Data.SqlServerCe.Entity para configurar el proveedor de datos de Entity Framework de modo que SQL Server Compact 3.5 se copie en el directorio de salida.
Agregue las bibliotecas nativas de 32 bits de SQL Server Compact 3.5 necesarias al proyecto.
1. En Explorador de soluciones, haga clic con el botón secundario en el proyecto, elija Agregar y seleccione Nueva carpeta. Asigne a la carpeta el nombre x86.
2. En el Explorador de soluciones, haga clic con el botón secundario en la carpeta x86, elija Agregar y seleccione Elemento existente.
3. En el cuadro de diálogo Agregar elemento existente, vaya a la carpeta en la que se encuentran las bibliotecas nativas de 32 bits. En una versión de Windows de 32 bits, esta carpeta es %Program Files%\Microsoft SQL Server Compact Edition\v3.5. En una versión de Windows de 64 bits, esta carpeta es %Program Files (x86)%\Microsoft SQL Server Compact Edition\v3.5.
4. Presione la tecla Control mientras hace clic en cada una de bibliotecas nativas necesarias para el proyecto para seleccionarlas en la lista de archivos y, a continuación, haga clic en Aceptar. Las bibliotecas se agregan a la carpeta x86.
  
  Nota
  
  Como mínimo, debe agregar las siguientes bibliotecas: sqlceme35.dll, sqlceqp35.dll, sqlcese35.dll y sqlceer35.dll.
Agregue las bibliotecas nativas de 64 bits de SQL Server Compact 3.5 necesarias al proyecto.
1. En Explorador de soluciones, haga clic con el botón secundario en el proyecto, elija Agregar y seleccione Nueva carpeta. Asigne a la carpeta el nombre x64.
2. En el Explorador de soluciones, haga clic con el botón secundario en la carpeta x64, elija Agregar y seleccione Elemento existente.
3. En el cuadro de diálogo Agregar elemento existente, vaya a la carpeta en la que se encuentran las bibliotecas nativas de 64 bits. En una versión de Windows de 64 bits, esta carpeta es %Program Files%\Microsoft SQL Server Compact Edition\v3.5.
  
  Nota
  
  No puede instalar la versión de 64 bits de SQL Server Compact 3.5 en un equipo que ejecute una versión de Windows de 32 bits. Debe extraer primero los archivos del instalador de 64 bits en un directorio del equipo de desarrollo para agregar las bibliotecas nativas de 64 bits a un proyecto que se va a integrar en un entorno de desarrollo de 32 bits. A continuación, puede ir a este directorio para agregar las bibliotecas nativas de 64 bits al proyecto. Para obtener información sobre cómo extraer los archivos del instalador, vea Extraer DLL de 64 bits del instalador de runtime de SQL Server Compact.
4. Presione la tecla Control mientras hace clic en cada una de bibliotecas nativas necesarias para el proyecto para seleccionarlas en la lista de archivos y, a continuación, haga clic en Aceptar. Las bibliotecas se agregan a la carpeta x64.
  
  Nota
  
  Como mínimo, debe agregar las siguientes bibliotecas: sqlceme35.dll, sqlceqp35.dll, sqlcese35.dll y sqlceer35.dll.
Configure cada una de las bibliotecas nativas agregadas en los pasos anteriores que se van a copiar en el directorio de salida cuando se genere el proyecto. Debe realizar esta operación para las bibliotecas de ambos directorios.
1. En Explorador de soluciones, haga clic con el botón secundario en la biblioteca (por ejemplo, sqlcese35.dll) y seleccione las propiedades.
  
  Nota
  
  Si los ensamblados no figuran en Explorador de soluciones, haga clic en Mostrar todos los archivos en la parte superior de Explorador de soluciones.
2. En Propiedades del archivo, seleccione Copiar siempre o Copiar si es posterior en la lista desplegable Copiar en el directorio de salida.
Configure el proyecto para compilarlo para Any CPU.
1. En Explorador de soluciones, haga clic con el botón secundario en el proyecto y seleccione Propiedades para abrir el Diseñador de proyectos.
2. Haga clic en Compilación y seleccione Any CPU en la lista desplegable Destino de la plataforma.

Usar objetos de SQL Server Compact 3.5

Una vez agregado el espacio de nombres System.Data.SqlServerCe, puede empezar a crear código que lo utilice mediante los objetos de SQL Server Compact 3.5. En el siguiente ejemplo de código se muestra cómo usar el objeto Engine para crear un archivo de base de datos de SQL Server Compact 3.5.

using System;
using System.Data.SqlServerCe;
using System.IO;

public class MySqlCeEngine
{
    public void CreateDB()
    {
        File.Delete("Test.sdf");
        string connString = "Data Source='Test.sdf'; LCID=1033;   Password=<enterStrongPasswordHere>; Encrypt = TRUE;";
        SqlCeEngine engine = new SqlCeEngine(connString);
        engine.CreateDatabase();
    }
}

Imports System
Imports System.Data.SqlServerCe
Imports System.IO

Public Class MySqlCeEngine

    Public Sub CreateDB()
        File.Delete("Test.sdf")
        Dim connString As String = "Data Source='Test.sdf'; LCID=1033; Password=<enterStrongPasswordHere>; Encrypt = TRUE;"
        Dim engine As New SqlCeEngine(connString)
        engine.CreateDatabase()
    End Sub
End Class

Vea también

Referencia

System.Data.SqlServerCe Namespace (documentación de referencia de .NET Framework)

Share via