Store los datos en una base de datos Local de SQLite.NETStore Data in a Local SQLite.NET Database

Descargar ejemplo descargar el ejemploDownload Sample Download the sample

En este tutorial, obtendrá información sobre cómo:In this quickstart, you will learn how to:

  • Use el Administrador de paquetes de NuGet para agregar un paquete de NuGet a un proyecto.Use the NuGet Package Manager to add a NuGet package to a project.
  • Store datos localmente en una base de datos de SQLite.NET.Store data locally in a SQLite.NET database.

La Guía de inicio rápido le guía a través almacenar datos en una base de datos local de SQLite.NET.The quickstart walks through how to store data in a local SQLite.NET database. A continuación se muestra la aplicación final:The final application is shown below:

Requisitos previosPrerequisites

Debe completar correctamente el inicio rápido anterior antes de intentar este inicio rápido.You should successfully complete the previous quickstart before attempting this quickstart. Como alternativa, descargue el anterior ejemplo de tutorial rápido y usarlo como punto de partida para este inicio rápido.Alternatively, download the previous quickstart sample and use it as the starting point for this quickstart.

Actualizar la aplicación con Visual StudioUpdate the app with Visual Studio

  1. Inicie Visual Studio y abra la solución de notas.Launch Visual Studio and open the Notes solution.

  2. En el Explorador de soluciones, seleccione el notas del proyecto, haga clic en y seleccione administrar paquetes NuGet... :In Solution Explorer, select the Notes project, right-click and select Manage NuGet Packages...:

  3. En el Administrador de paquetes NuGet, seleccione la pestaña Examinar, busque el paquete NuGet sqlite-net-pcl, selecciónelo y haga clic en el botón Instalar para agregarlo al proyecto:In the NuGet Package Manager, select the Browse tab, search for the sqlite-net-pcl NuGet package, select it, and click the Install button to add it to the project:

    Nota

    Hay varios paquetes NuGet con nombres similares.There are a number of NuGet packages with similar names. El paquete correcto tiene estos atributos:The correct package has these attributes:

    • Autores: Frank A. KruegerAuthor(s): Frank A. Krueger
    • Id.: sqlite-net-pclId: sqlite-net-pcl
    • Vínculo de NuGet: sqlite-net-pclNuGet link: sqlite-net-pcl

    A pesar del nombre del paquete, este paquete NuGet puede usarse en proyectos de .NET Standard.Despite the package name, this NuGet package can be used in .NET Standard projects.

    Este paquete se usará para incorporar operaciones de bases de datos en la aplicación.This package will be used to incorporate database operations into the application.

  4. En el Explorador de soluciones, en el notas proyecto, abra Note.cs en el modelos reemplazar el existente y carpeta de código con el código siguiente:In Solution Explorer, in the Notes project, open Note.cs in the Models folder and replace the existing code with the following code:

    using System;
    using SQLite;
    
    namespace Notes.Models
    {
        public class Note
        {
            [PrimaryKey, AutoIncrement]
            public int ID { get; set; }
            public string Text { get; set; }
            public DateTime Date { get; set; }
        }
    }
    

    Esta clase define un Note modelo donde se almacenará los datos sobre todas las notas de la aplicación.This class defines a Note model that will store data about each note in the application. El ID propiedad está marcada con PrimaryKey y AutoIncrement atributos para asegurarse de que cada Note instancia en la base de datos de SQLite.NET tendrá un identificador único proporcionado por SQLite.NET.The ID property is marked with PrimaryKey and AutoIncrement attributes to ensure that each Note instance in the SQLite.NET database will have a unique id provided by SQLite.NET.

    Guarde los cambios en Note.cs presionando CTRL+Sy cierre el archivo.Save the changes to Note.cs by pressing CTRL+S, and close the file.

    Advertencia

    Al intentar compilar la aplicación en este momento se producirá errores que se corregirán en pasos posteriores.Attempting to build the application at this point will result in errors that will be fixed in subsequent steps.

  5. En el Explorador de soluciones, agregue una nueva carpeta denominada datos a la notas proyecto.In Solution Explorer, add a new folder named Data to the Notes project.

  6. En el Explorador de soluciones, en el notas proyecto, agregar una nueva clase denominada NoteDatabase a la datos carpeta.In Solution Explorer, in the Notes project, add a new class named NoteDatabase to the Data folder.

  7. En NoteDatabase.cs, reemplace el código existente por el código siguiente:In NoteDatabase.cs, replace the existing code with the following code:

    using System.Collections.Generic;
    using System.Threading.Tasks;
    using SQLite;
    using Notes.Models;
    
    namespace Notes.Data
    {
        public class NoteDatabase
        {
            readonly SQLiteAsyncConnection _database;
    
            public NoteDatabase(string dbPath)
            {
                _database = new SQLiteAsyncConnection(dbPath);
                _database.CreateTableAsync<Note>().Wait();
            }
    
            public Task<List<Note>> GetNotesAsync()
            {
                return _database.Table<Note>().ToListAsync();
            }
    
            public Task<Note> GetNoteAsync(int id)
            {
                return _database.Table<Note>()
                                .Where(i => i.ID == id)
                                .FirstOrDefaultAsync();
            }
    
            public Task<int> SaveNoteAsync(Note note)
            {
                if (note.ID != 0)
                {
                    return _database.UpdateAsync(note);
                }
                else
                {
                    return _database.InsertAsync(note);
                }
            }
    
            public Task<int> DeleteNoteAsync(Note note)
            {
                return _database.DeleteAsync(note);
            }
        }
    }
    

    Esta clase contiene código para crear la base de datos, leen datos, escribir datos en él y eliminar datos.This class contains code to create the database, read data from it, write data to it, and delete data from it. El código usa API asincrónicas de SQLite.NET que mueven las operaciones de base de datos a subprocesos en segundo plano.The code uses asynchronous SQLite.NET APIs that move database operations to background threads. Además, el constructor NoteDatabase toma la ruta de acceso del archivo de base de datos como un argumento.In addition, the NoteDatabase constructor takes the path of the database file as an argument. Esta ruta de acceso será proporcionado por el App clase en el paso siguiente.This path will be provided by the App class in the next step.

    Guarde los cambios en NoteDatabase.cs presionando CTRL+Sy cierre el archivo.Save the changes to NoteDatabase.cs by pressing CTRL+S, and close the file.

    Advertencia

    Al intentar compilar la aplicación en este momento se producirá errores que se corregirán en pasos posteriores.Attempting to build the application at this point will result in errors that will be fixed in subsequent steps.

  8. En el Explorador de soluciones, en el notas del proyecto, haga doble clic en App.xaml.cs para abrirlo.In Solution Explorer, in the Notes project, double-click App.xaml.cs to open it. A continuación, reemplace el código existente por el código siguiente:Then replace the existing code with the following code:

    using System;
    using System.IO;
    using Xamarin.Forms;
    using Notes.Data;
    
    namespace Notes
    {
        public partial class App : Application
        {
            static NoteDatabase database;
    
            public static NoteDatabase Database
            {
                get
                {
                    if (database == null)
                    {
                        database = new NoteDatabase(Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "Notes.db3"));
                    }
                    return database;
                }
            }
    
            public App()
            {
                InitializeComponent();
                MainPage = new NavigationPage(new NotesPage());
            }
            ...
        }
    }
    

    Este código define un Database propiedad que se crea un nuevo NoteDatabase instancia como un singleton, pasando el nombre de archivo de la base de datos como el argumento para el NoteDatabase constructor.This code defines a Database property that creates a new NoteDatabase instance as a singleton, passing in the filename of the database as the argument to the NoteDatabase constructor. La ventaja de exponer la base de datos como un singleton es que se crea una conexión de base de datos única que se mantiene abierta mientras la aplicación se ejecuta, lo que evita el gasto de abrir y cerrar el archivo de base de datos cada vez que se realiza una operación de base de datos.The advantage of exposing the database as a singleton is that a single database connection is created that's kept open while the application runs, therefore avoiding the expense of opening and closing the database file each time a database operation is performed.

    Guarde los cambios en App.xaml.cs presionando CTRL+S y cierre el archivo.Save the changes to App.xaml.cs by pressing CTRL+S, and close the file.

    Advertencia

    Al intentar compilar la aplicación en este momento se producirá errores que se corregirán en pasos posteriores.Attempting to build the application at this point will result in errors that will be fixed in subsequent steps.

  9. En el Explorador de soluciones, en el notas del proyecto, haga doble clic en NotesPage.xaml.cs para abrirlo.In Solution Explorer, in the Notes project, double-click NotesPage.xaml.cs to open it. A continuación, reemplace el OnAppearing método con el código siguiente:Then replace the OnAppearing method with the following code:

    protected override async void OnAppearing()
    {
        base.OnAppearing();
    
        listView.ItemsSource = await App.Database.GetNotesAsync();
    }
    

    Este código rellena la ListView con las notas que se almacenan en la base de datos.This code populates the ListView with any notes stored in the database.

    Guarde los cambios en NotesPage.xaml.cs presionando CTRL+Sy cierre el archivo.Save the changes to NotesPage.xaml.cs by pressing CTRL+S, and close the file.

    Advertencia

    Al intentar compilar la aplicación en este momento se producirá errores que se corregirán en pasos posteriores.Attempting to build the application at this point will result in errors that will be fixed in subsequent steps.

  10. En el Explorador de soluciones, haga doble clic en NoteEntryPage.xaml.cs para abrirlo.In Solution Explorer, double-click NoteEntryPage.xaml.cs to open it. A continuación, reemplace el OnSaveButtonClicked y OnDeleteButtonClicked métodos con el código siguiente:Then replace the OnSaveButtonClicked and OnDeleteButtonClicked methods with the following code:

    async void OnSaveButtonClicked(object sender, EventArgs e)
    {
        var note = (Note)BindingContext;
        note.Date = DateTime.UtcNow;
        await App.Database.SaveNoteAsync(note);
        await Navigation.PopAsync();
    }
    
    async void OnDeleteButtonClicked(object sender, EventArgs e)
    {
        var note = (Note)BindingContext;
        await App.Database.DeleteNoteAsync(note);
        await Navigation.PopAsync();
    }
    

    El NoteEntryPage almacena un Note instancia, que representa una sola nota, en el BindingContext de la página.The NoteEntryPage stores a Note instance, which represents a single note, in the BindingContext of the page. Cuando el OnSaveButtonClicked se ejecuta el controlador de eventos, el Note instancia se guarda en la base de datos y la aplicación regresa a la página anterior.When the OnSaveButtonClicked event handler is executed, the Note instance is saved to the database and the application navigates back to the previous page. Cuando el OnDeleteButtonClicked se ejecuta el controlador de eventos, el Note instancia se elimina de la base de datos y la aplicación regresa a la página anterior.When the OnDeleteButtonClicked event handler is executed, the Note instance is deleted from the database and the application navigates back to the previous page.

    Guarde los cambios en NoteEntryPage.xaml.cs presionando CTRL+Sy cierre el archivo.Save the changes to NoteEntryPage.xaml.cs by pressing CTRL+S, and close the file.

  11. Compile y ejecute el proyecto en cada plataforma.Build and run the project on each platform. Para obtener más información, consulte crear la Guía de inicio rápido.For more information, see Building the quickstart.

    En el NotesPage presione el + botón para navegar a la NoteEntryPage y escriba una nota.On the NotesPage press the + button to navigate to the NoteEntryPage and enter a note. Después de guardar la nota de la aplicación navegará a la NotesPage.After saving the note the application will navigate back to the NotesPage.

    Escriba un número de notas, de longitud variable, observar el comportamiento de la aplicación.Enter a number of notes, of varying length, to observe the application behavior.

Actualizar la aplicación con Visual Studio para MacUpdate the app with Visual Studio for Mac

  1. Inicie Visual Studio para Mac y abra el proyecto de notas.Launch Visual Studio for Mac and open the Notes project.

  2. En el panel de solución, seleccione el notas del proyecto, haga clic en y seleccione Agregar > Agregar paquetes NuGet... :In the Solution Pad, select the Notes project, right-click and select Add > Add NuGet Packages...:

  3. En la ventana Agregar paquetes, busque el paquete NuGet sqlite-net-pcl, selecciónelo y haga clic en el botón Agregar paquete para agregarlo al proyecto:In the Add Packages window, search for the sqlite-net-pcl NuGet package, select it, and click the Add Package button to add it to the project:

    Nota

    Hay varios paquetes NuGet con nombres similares.There are a number of NuGet packages with similar names. El paquete correcto tiene estos atributos:The correct package has these attributes:

    • Autor: Frank A. KruegerAuthor: Frank A. Krueger
    • Id.: sqlite-net-pclId: sqlite-net-pcl
    • Vínculo de NuGet: sqlite-net-pclNuGet link: sqlite-net-pcl

    A pesar del nombre del paquete, este paquete NuGet puede usarse en proyectos de .NET Standard.Despite the package name, this NuGet package can be used in .NET Standard projects.

    Este paquete se usará para incorporar operaciones de bases de datos en la aplicación.This package will be used to incorporate database operations into the application.

  4. En el panel de solución, en el notas proyecto, abra Note.cs en el modelos carpeta y reemplace el código existente por lo siguiente código:In the Solution Pad, in the Notes project, open Note.cs in the Models folder and replace the existing code with the following code:

    using System;
    using SQLite;
    
    namespace Notes.Models
    {
        public class Note
        {
            [PrimaryKey, AutoIncrement]
            public int ID { get; set; }
            public string Text { get; set; }
            public DateTime Date { get; set; }
        }
    }
    

    Esta clase define un Note modelo donde se almacenará los datos sobre todas las notas de la aplicación.This class defines a Note model that will store data about each note in the application. El ID propiedad está marcada con PrimaryKey y AutoIncrement atributos para asegurarse de que cada Note instancia en la base de datos de SQLite.NET tendrá un identificador único proporcionado por SQLite.NET.The ID property is marked with PrimaryKey and AutoIncrement attributes to ensure that each Note instance in the SQLite.NET database will have a unique id provided by SQLite.NET.

    Guarde los cambios en Note.cs eligiendo archivo > Guardar (o presionando ⌘ + S) y cierre el archivo.Save the changes to Note.cs by choosing File > Save (or by pressing ⌘ + S), and close the file.

    Advertencia

    Al intentar compilar la aplicación en este momento se producirá errores que se corregirán en pasos posteriores.Attempting to build the application at this point will result in errors that will be fixed in subsequent steps.

  5. En el panel de solución, agregue una nueva carpeta denominada datos a la notas proyecto.In the Solution Pad, add a new folder named Data to the Notes project.

  6. En el panel de solución, en el notas proyecto, agregar una nueva clase denominada NoteDatabase a la datos carpeta.In the Solution Pad, in the Notes project, add a new class named NoteDatabase to the Data folder.

  7. En NoteDatabase.cs, reemplace el código existente por el código siguiente:In NoteDatabase.cs, replace the existing code with the following code:

    using System.Collections.Generic;
    using System.Threading.Tasks;
    using SQLite;
    using Notes.Models;
    
    namespace Notes.Data
    {
        public class NoteDatabase
        {
            readonly SQLiteAsyncConnection _database;
    
            public NoteDatabase(string dbPath)
            {
                _database = new SQLiteAsyncConnection(dbPath);
                _database.CreateTableAsync<Note>().Wait();
            }
    
            public Task<List<Note>> GetNotesAsync()
            {
                return _database.Table<Note>().ToListAsync();
            }
    
            public Task<Note> GetNoteAsync(int id)
            {
                return _database.Table<Note>()
                                .Where(i => i.ID == id)
                                .FirstOrDefaultAsync();
            }
    
            public Task<int> SaveNoteAsync(Note note)
            {
                if (note.ID != 0)
                {
                    return _database.UpdateAsync(note);
                }
                else
                {
                    return _database.InsertAsync(note);
                }
            }
    
            public Task<int> DeleteNoteAsync(Note note)
            {
                return _database.DeleteAsync(note);
            }
        }
    }
    

    Esta clase contiene código para crear la base de datos, leen datos, escribir datos en él y eliminar datos.This class contains code to create the database, read data from it, write data to it, and delete data from it. El código usa API asincrónicas de SQLite.NET que mueven las operaciones de base de datos a subprocesos en segundo plano.The code uses asynchronous SQLite.NET APIs that move database operations to background threads. Además, el constructor NoteDatabase toma la ruta de acceso del archivo de base de datos como un argumento.In addition, the NoteDatabase constructor takes the path of the database file as an argument. Esta ruta de acceso será proporcionado por el App clase en el paso siguiente.This path will be provided by the App class in the next step.

    Guarde los cambios en NoteDatabase.cs eligiendo archivo > Guardar (o presionando ⌘ + S) y cierre el archivo.Save the changes to NoteDatabase.cs by choosing File > Save (or by pressing ⌘ + S), and close the file.

    Advertencia

    Al intentar compilar la aplicación en este momento se producirá errores que se corregirán en pasos posteriores.Attempting to build the application at this point will result in errors that will be fixed in subsequent steps.

  8. En el panel de solución, en el notas del proyecto, haga doble clic en App.xaml.cs para abrirlo.In the Solution Pad, in the Notes project, double-click App.xaml.cs to open it. A continuación, reemplace el código existente por el código siguiente:Then replace the existing code with the following code:

    using System;
    using System.IO;
    using Xamarin.Forms;
    using Notes.Data;
    
    namespace Notes
    {
        public partial class App : Application
        {
            static NoteDatabase database;
    
            public static NoteDatabase Database
            {
                get
                {
                    if (database == null)
                    {
                        database = new NoteDatabase(Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "Notes.db3"));
                    }
                    return database;
                }
            }
    
            public App()
            {
                InitializeComponent();
                MainPage = new NavigationPage(new NotesPage());
            }
            ...
        }
    }
    

    Este código define un Database propiedad que se crea un nuevo NoteDatabase instancia como un singleton, pasando el nombre de archivo de la base de datos como el argumento para el NoteDatabase constructor.This code defines a Database property that creates a new NoteDatabase instance as a singleton, passing in the filename of the database as the argument to the NoteDatabase constructor. La ventaja de exponer la base de datos como un singleton es que se crea una conexión de base de datos única que se mantiene abierta mientras la aplicación se ejecuta, lo que evita el gasto de abrir y cerrar el archivo de base de datos cada vez que se realiza una operación de base de datos.The advantage of exposing the database as a singleton is that a single database connection is created that's kept open while the application runs, therefore avoiding the expense of opening and closing the database file each time a database operation is performed.

    Guarde los cambios en App.xaml.cs eligiendo Archivo > Guardar (o presionando ⌘ + S) y cierre el archivo.Save the changes to App.xaml.cs by choosing File > Save (or by pressing ⌘ + S), and close the file.

    Advertencia

    Al intentar compilar la aplicación en este momento se producirá errores que se corregirán en pasos posteriores.Attempting to build the application at this point will result in errors that will be fixed in subsequent steps.

  9. En el panel de solución, en el notas del proyecto, haga doble clic en NotesPage.xaml.cs para abrirlo.In the Solution Pad, in the Notes project, double-click NotesPage.xaml.cs to open it. A continuación, reemplace el OnAppearing método con el código siguiente:Then replace the OnAppearing method with the following code:

    protected override async void OnAppearing()
    {
        base.OnAppearing();
    
        listView.ItemsSource = await App.Database.GetNotesAsync();
    }
    

    Este código rellena la ListView con las notas que se almacenan en la base de datos.This code populates the ListView with any notes stored in the database.

    Guarde los cambios en NotesPage.xaml.cs eligiendo archivo > Guardar (o presionando ⌘ + S) y cierre el archivo.Save the changes to NotesPage.xaml.cs by choosing File > Save (or by pressing ⌘ + S), and close the file.

    Advertencia

    Al intentar compilar la aplicación en este momento se producirá errores que se corregirán en pasos posteriores.Attempting to build the application at this point will result in errors that will be fixed in subsequent steps.

  10. En el panel de solución, haga doble clic en NoteEntryPage.xaml.cs para abrirlo.In the Solution Pad, double-click NoteEntryPage.xaml.cs to open it. A continuación, reemplace el OnSaveButtonClicked y OnDeleteButtonClicked métodos con el código siguiente:Then replace the OnSaveButtonClicked and OnDeleteButtonClicked methods with the following code:

    async void OnSaveButtonClicked(object sender, EventArgs e)
    {
        var note = (Note)BindingContext;
        note.Date = DateTime.UtcNow;
        await App.Database.SaveNoteAsync(note);
        await Navigation.PopAsync();
    }
    
    async void OnDeleteButtonClicked(object sender, EventArgs e)
    {
        var note = (Note)BindingContext;
        await App.Database.DeleteNoteAsync(note);
        await Navigation.PopAsync();
    }
    

    El NoteEntryPage almacena un Note instancia, que representa una sola nota, en el BindingContext de la página.The NoteEntryPage stores a Note instance, which represents a single note, in the BindingContext of the page. Cuando el OnSaveButtonClicked se ejecuta el controlador de eventos, el Note instancia se guarda en la base de datos y la aplicación regresa a la página anterior.When the OnSaveButtonClicked event handler is executed, the Note instance is saved to the database and the application navigates back to the previous page. Cuando el OnDeleteButtonClicked se ejecuta el controlador de eventos, el Note instancia se elimina de la base de datos y la aplicación regresa a la página anterior.When the OnDeleteButtonClicked event handler is executed, the Note instance is deleted from the database and the application navigates back to the previous page.

    Guarde los cambios en NoteEntryPage.xaml.cs eligiendo archivo > Guardar (o presionando ⌘ + S) y cierre el archivo.Save the changes to NoteEntryPage.xaml.cs by choosing File > Save (or by pressing ⌘ + S), and close the file.

  11. Compile y ejecute el proyecto en cada plataforma.Build and run the project on each platform. Para obtener más información, consulte crear la Guía de inicio rápido.For more information, see Building the quickstart.

    En el NotesPage presione el + botón para navegar a la NoteEntryPage y escriba una nota.On the NotesPage press the + button to navigate to the NoteEntryPage and enter a note. Después de guardar la nota de la aplicación navegará a la NotesPage.After saving the note the application will navigate back to the NotesPage.

    Escriba un número de notas, de longitud variable, observar el comportamiento de la aplicación.Enter a number of notes, of varying length, to observe the application behavior.

Pasos siguientesNext steps

En este tutorial, ha aprendido cómo:In this quickstart, you learned how to:

  • Use el Administrador de paquetes de NuGet para agregar un paquete de NuGet a un proyecto.Use the NuGet Package Manager to add a NuGet package to a project.
  • Store datos localmente en una base de datos de SQLite.NET.Store data locally in a SQLite.NET database.

Para aplicar estilo a la aplicación con los estilos XAML, continúe con el siguiente inicio rápido.To style the application with XAML styles, continue to the next quickstart.