Xamarin.Forms Kurz místní databáze

Než se pustíte do tohoto kurzu, měli byste úspěšně dokončit tyto položky:

Vytvořte svůj první Xamarin.Forms rychlý start k aplikaci .
Kurz k objektu StackLayout
Kurz o objektu Button
Kurz o objektu Entry
Kurz k objektu CollectionView

V tomto kurzu se naučíte:

Pomocí Správce balíčků NuGet můžete do projektu přidat SQLite.NETXamarin.Forms.
Vytvořit třídy pro přístup k datům
Využití tříd pro přístup k datům

V sadě Visual Studio 2019 nebo Visual Studio pro Mac vytvoříte jednoduchou aplikaci, která předvádí, jak ukládat data do místní databáze SQLite.NET. Na následujících snímcích obrazovky je zachycena finální aplikace:

Add SQLite.NET

11 min zbývá

Visual Studio
Visual Studio pro Mac

K dokončení tohoto kurzu byste měli mít Visual Studio 2019 (nejnovější vydanou verzi) s nainstalovanou sadou funkcí Vývoj mobilních aplikací pomocí .NET. Kromě toho budete potřebovat spárovaný Mac pro sestavení aplikace z kurzu v iOSu. Informace o instalaci platformy Xamarin najdete v článku Instalace Xamarinu. Informace o připojení sady Visual Studio 2019 k hostiteli buildu pro Mac najdete v článku Spárování s počítačem Mac pro vývoj na platformě Xamarin.iOS.

Spusťte Visual Studio a vytvořte novou prázdnou Xamarin.Forms aplikaci s názvem LocalDatabaseTutorial.

Důležité

Fragmenty kódu C# a XAML v tomto kurzu vyžadují, aby řešení mělo název LocalDatabaseTutorial. Použití jiného názvu způsobí při kopírování kódu z tohoto kurzu do řešení chyby sestavení.

Další informace o knihovně .NET Standard, která se vytvoří, najdete v tématu Anatomie Xamarin.Forms aplikace v podrobném Xamarin.Forms kurzu Rychlý start.
V Průzkumníkovi řešení vyberte projekt LocalDatabaseTutorial, klikněte na něj pravým tlačítkem a vyberte Spravovat balíčky NuGet:
Ve Správci balíčků NuGet vyberte kartu Procházet, vyhledejte balíček NuGet sqlite-net-pcl, vyberte ho a kliknutím na tlačítko Nainstalovat ho přidejte do projektu:
Poznámka:

Existuje mnoho balíčků NuGet s podobnými názvy. Správný balíček má tyto atributy:
- Autoři: SQLite-net
- Odkaz NuGet: sqlite-net-pcl
Bez ohledu na název balíčku je možné tento balíček NuGet použít v projektech .NET Standard.
Tento balíček poslouží k začlenění databázových operací do aplikace.

Důležité

SQLite.NET je knihovna třetí strany podporovaná z úložiště praeclarum/sqlite-net.
Sestavte řešení a zajistěte, aby neobsahovalo chyby.

Vytvořit třídy pro přístup k datům

8 min zbývá

V tomto cvičení přidáte do projektu LocalDatabaseTutorial třídy pro přístup k datům, které budou sloužit k trvalému ukládání dat o lidech do databáze.

Visual Studio
Visual Studio pro Mac

V Průzkumníkovi řešení přidejte do projektu LocalDatabaseTutorial novou třídu s názvem Person. Pak v souboru Person.cs odeberte veškerý kód šablony a nahraďte ho následujícím kódem:
```
using SQLite;

namespace LocalDatabaseTutorial
{
    public class Person
    {
        [PrimaryKey, AutoIncrement]
        public int ID { get; set; }
        public string Name { get; set; }
        public int Age { get; set; }
    }
}
```
Tento kód definuje třídu Person, která bude sloužit k ukládání dat o každé osobě v aplikaci. Vlastnost ID je označená pomocí atributů PrimaryKey a AutoIncrement, aby každá instance třídy Person v databázi měla jedinečné ID poskytované knihovnou SQLite.NET.

V Průzkumníkovi řešení přidejte do projektu LocalDatabaseTutorial novou třídu s názvem Database. Pak v souboru Database.cs odeberte veškerý kód šablony a nahraďte ho následujícím kódem:

using System.Collections.Generic;
using System.Threading.Tasks;
using SQLite;

namespace LocalDatabaseTutorial
{
    public class Database
    {
        readonly SQLiteAsyncConnection _database;

        public Database(string dbPath)
        {
            _database = new SQLiteAsyncConnection(dbPath);
            _database.CreateTableAsync<Person>().Wait();
        }

        public Task<List<Person>> GetPeopleAsync()
        {
            return _database.Table<Person>().ToListAsync();
        }

        public Task<int> SavePersonAsync(Person person)
        {
            return _database.InsertAsync(person);
        }
    }
}

Tato třída obsahuje kód pro vytvoření databáze, čtení dat z databáze a zápis dat do databáze. Tento kód používá asynchronní rozhraní API SQLite.NET, která přesouvají databázové operace na vlákna na pozadí. Konstruktor třídy Database kromě toho přijímá jako argument cestu k souboru databáze. Tuto cestu poskytneme v dalším cvičení pomocí třídy App.

V Průzkumníkovi řešení v projektu LocalDatabaseTutorial rozbalte uzel App.xaml a poklikáním otevřete soubor App.xaml.cs. Pak v souboru App.xaml.cs odeberte veškerý kód šablony a nahraďte ho následujícím kódem:

using System;
using System.IO;
using Xamarin.Forms;

namespace LocalDatabaseTutorial
{
    public partial class App : Application
    {
        static Database database;

        public static Database Database
        {
            get
            {
                if (database == null)
                {
                    database = new Database(Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "people.db3"));
                }
                return database;
            }
        }

        public App()
        {
            InitializeComponent();

            MainPage = new MainPage();
        }

        protected override void OnStart()
        {
            // Handle when your app starts
        }

        protected override void OnSleep()
        {
            // Handle when your app sleeps
        }

        protected override void OnResume()
        {
            // Handle when your app resumes
        }
    }
}

Tento kód definuje vlastnost Database, která vytvoří novou instanci Database jako jednoúčelovou databázi. Konstruktoru třídy Database je jako argument předána místní cesta k souboru a název souboru (určuje místo uložení databáze).

Důležité

Výhodou vystavení databáze jako jednoúčelové je to, že se vytvoří jedno připojení k databázi, které zůstává otevřené po dobu běhu aplikace, takže není nutné při provádění každé databázové operace otevírat a zavírat soubor databáze.

Sestavte řešení a zajistěte, aby neobsahovalo chyby.

V Oblasti řešení přidejte do projektu LocalDatabaseTutorial novou třídu s názvem Person. Pak v souboru Person.cs odeberte veškerý kód šablony a nahraďte ho následujícím kódem:
```
using SQLite;

namespace LocalDatabaseTutorial
{
    public class Person
    {
        [PrimaryKey, AutoIncrement]
        public int ID { get; set; }
        public string Name { get; set; }
        public int Age { get; set; }
    }
}
```
Tento kód definuje třídu Person, která bude sloužit k ukládání dat o každé osobě v aplikaci. Vlastnost ID je označená pomocí atributů PrimaryKey a AutoIncrement, aby každá instance třídy Person v databázi měla jedinečné ID poskytované knihovnou SQLite.NET.

V Oblasti řešení přidejte do projektu LocalDatabaseTutorial novou třídu s názvem Database. Pak v souboru Database.cs odeberte veškerý kód šablony a nahraďte ho následujícím kódem:

using System.Collections.Generic;
using System.Threading.Tasks;
using SQLite;

namespace LocalDatabaseTutorial
{
    public class Database
    {
        readonly SQLiteAsyncConnection _database;

        public Database(string dbPath)
        {
            _database = new SQLiteAsyncConnection(dbPath);
            _database.CreateTableAsync<Person>().Wait();
        }

        public Task<List<Person>> GetPeopleAsync()
        {
            return _database.Table<Person>().ToListAsync();
        }

        public Task<int> SavePersonAsync(Person person)
        {
            return _database.InsertAsync(person);
        }
    }
}

Tato třída obsahuje kód pro vytvoření databáze, čtení dat z databáze a zápis dat do databáze. Tento kód používá asynchronní rozhraní API SQLite.NET, která přesouvají databázové operace na vlákna na pozadí. Konstruktor třídy Database kromě toho přijímá jako argument cestu k souboru databáze. Tuto cestu poskytneme v dalším cvičení pomocí třídy App.

V Oblasti řešení v projektu LocalDatabaseTutorial rozbalte uzel App.xaml a poklikáním otevřete soubor App.xaml.cs. Pak v souboru App.xaml.cs odeberte veškerý kód šablony a nahraďte ho následujícím kódem:

using System;
using System.IO;
using Xamarin.Forms;

namespace LocalDatabaseTutorial
{
    public partial class App : Application
    {
        static Database database;

        public static Database Database
        {
            get
            {
                if (database == null)
                {
                    database = new Database(Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "people.db3"));
                }
                return database;
            }
        }

        public App()
        {
            InitializeComponent();

            MainPage = new MainPage();
        }

        protected override void OnStart()
        {
            // Handle when your app starts
        }

        protected override void OnSleep()
        {
            // Handle when your app sleeps
        }

        protected override void OnResume()
        {
            // Handle when your app resumes
        }
    }
}

Tento kód definuje vlastnost Database, která vytvoří novou instanci Database jako jednoúčelovou databázi. Konstruktoru třídy Database je jako argument předána místní cesta k souboru a název souboru (určuje místo uložení databáze).

Důležité

Výhodou vystavení databáze jako jednoúčelové je to, že se vytvoří jedno připojení k databázi, které zůstává otevřené po dobu běhu aplikace, takže není nutné při provádění každé databázové operace otevírat a zavírat soubor databáze.

Sestavte řešení a zajistěte, aby neobsahovalo chyby.

Využít třídy pro přístup k datům

3 min zbývá

V tomto cvičení vytvoříte uživatelské rozhraní, které bude využívat dříve vytvořené třídy pro přístup k datům.

Visual Studio
Visual Studio pro Mac

V Průzkumníkovi řešení v projektu LocalDatabaseTutorial poklikáním otevřete soubor MainPage.xaml. Pak v souboru MainPage.xaml odeberte veškerý kód šablony a nahraďte ho následujícím kódem:
```
<?xml version="1.0" encoding="utf-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="LocalDatabaseTutorial.MainPage">
    <StackLayout Margin="20,35,20,20">
        <Entry x:Name="nameEntry"
               Placeholder="Enter name" />
        <Entry x:Name="ageEntry"
               Placeholder="Enter age" />
        <Button Text="Add to Database"
                Clicked="OnButtonClicked" />
        <CollectionView x:Name="collectionView">
            <CollectionView.ItemTemplate>
                <DataTemplate>
                    <StackLayout>
                        <Label Text="{Binding Name}"
                               FontSize="Medium" />
                        <Label Text="{Binding Age}"
                               TextColor="Silver"
                               FontSize="Small" />
                    </StackLayout>
                </DataTemplate>
            </CollectionView.ItemTemplate>
        </CollectionView>
    </StackLayout>
</ContentPage>
```
Tento kód deklarativně definuje uživatelské rozhraní pro stránku, která se skládá z dvou instancí Entry, objektu Button a objektu CollectionView v StackLayout. Každá instance Entry má nastavenou svoji vlastnost Placeholder, která určuje zástupný text, který se zobrazuje před zadáním vstupu uživatele. Objekt Button nastaví svoji událost Clicked na obslužnou rutinu události s názvem OnButtonClicked, která bude vytvořena v dalším kroku. Objekt CollectionView nastaví svoji vlastnost ItemTemplate na DataTemplate, která použije objekt StackLayout a dva objekty Label k definování vzhledu každého řádku v objektu CollectionView. Objekty Label vytvoří vazbu svých vlastností Text na vlastnosti Name a Age každého objektu Person v uvedeném pořadí.

Kromě toho instance Entry a objekt CollectionView mají názvy zadané atributem x:Name. Soubor kódu tak může přistupovat k těmto objektům pomocí přiřazených názvů.
V Průzkumníkovi řešení v projektu LocalDatabaseTutorial rozbalte uzel MainPage.xaml a poklikáním otevřete soubor MainPage.xaml.cs. Potom v souboru MainPage.xaml.cs přidejte do třídy přepsání OnAppearing a obslužnou rutinu události OnButtonClicked:
```
protected override async void OnAppearing()
{
    base.OnAppearing();
    collectionView.ItemsSource = await App.Database.GetPeopleAsync();
}

async void OnButtonClicked(object sender, EventArgs e)
{
    if (!string.IsNullOrWhiteSpace(nameEntry.Text) && !string.IsNullOrWhiteSpace(ageEntry.Text))
    {
        await App.Database.SavePersonAsync(new Person
        {
            Name = nameEntry.Text,
            Age = int.Parse(ageEntry.Text)
        });

        nameEntry.Text = ageEntry.Text = string.Empty;
        collectionView.ItemsSource = await App.Database.GetPeopleAsync();
    }
}
```
Metoda OnAppearing naplní CollectionView všemi daty uloženými v databázi. Metoda OnButtonClicked, která se spustí po klepnutí na Button, zadané údaje uloží do databáze před vymazáním obou instancí Entry a aktualizováním dat v objektu CollectionView.

Poznámka:

Přepsání metody OnAppearing se spustí až po rozložení ContentPage, ale těsně předtím, než se stane viditelným. Proto je to vhodné místo pro nastavení obsahu Xamarin.Forms zobrazení.
Na panelu nástrojů sady Visual Studio stiskněte tlačítko Spustit (trojúhelníkové tlačítko, která se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném vzdáleném simulátoru iOSu nebo emulátoru Androidu.

Zadejte několik položek dat a pro každou z nich klepněte na Button. Tím se data uloží do databáze a CollectionView se znovu vyplní všemi databázovými daty:

V sadě Visual Studio zastavte aplikaci.

Další informace o místních databázích naleznete v Xamarin.Formstématu Xamarin.Forms Místní databáze (průvodce)

V Oblasti řešení v projektu LocalDatabaseTutorial poklikáním otevřete soubor MainPage.xaml. Pak v souboru MainPage.xaml odeberte veškerý kód šablony a nahraďte ho následujícím kódem:
```
<?xml version="1.0" encoding="utf-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="LocalDatabaseTutorial.MainPage">
    <StackLayout Margin="20,35,20,20">
        <Entry x:Name="nameEntry"
               Placeholder="Enter name" />
        <Entry x:Name="ageEntry"
               Placeholder="Enter age" />
        <Button Text="Add to Database"
                Clicked="OnButtonClicked" />
        <CollectionView x:Name="collectionView">
            <CollectionView.ItemTemplate>
                <DataTemplate>
                    <StackLayout>
                        <Label Text="{Binding Name}"
                               FontSize="Medium" />
                        <Label Text="{Binding Age}"
                               TextColor="Silver"
                               FontSize="Small" />
                    </StackLayout>
                </DataTemplate>
            </CollectionView.ItemTemplate>
        </CollectionView>
    </StackLayout>
</ContentPage>
```
Tento kód deklarativně definuje uživatelské rozhraní pro stránku, která se skládá z dvou instancí Entry, objektu Button a objektu CollectionView v StackLayout. Každá instance Entry má nastavenou svoji vlastnost Placeholder, která určuje zástupný text, který se zobrazuje před zadáním vstupu uživatele. Objekt Button nastaví svoji událost Clicked na obslužnou rutinu události s názvem OnButtonClicked, která bude vytvořena v dalším kroku. Objekt CollectionView nastaví svoji vlastnost ItemTemplate na DataTemplate, která použije objekt StackLayout a dva objekty Label k definování vzhledu každého řádku v objektu CollectionView. Objekty Label vytvoří vazbu svých vlastností Text na vlastnosti Name a Age každého objektu Person v uvedeném pořadí.

Kromě toho instance Entry a objekt ListView mají názvy zadané atributem x:Name. Soubor kódu tak může přistupovat k těmto objektům pomocí přiřazených názvů.
V Oblasti řešení v projektu LocalDatabaseTutorial rozbalte uzel MainPage.xaml a poklikáním otevřete soubor MainPage.xaml.cs. Potom v souboru MainPage.xaml.cs přidejte do třídy přepsání OnAppearing a obslužnou rutinu události OnButtonClicked:
```
protected override async void OnAppearing()
{
    base.OnAppearing();
    collectionView.ItemsSource = await App.Database.GetPeopleAsync();
}

async void OnButtonClicked(object sender, EventArgs e)
{
    if (!string.IsNullOrWhiteSpace(nameEntry.Text) && !string.IsNullOrWhiteSpace(ageEntry.Text))
    {
        await App.Database.SavePersonAsync(new Person
        {
            Name = nameEntry.Text,
            Age = int.Parse(ageEntry.Text)
        });

        nameEntry.Text = ageEntry.Text = string.Empty;
        collectionView.ItemsSource = await App.Database.GetPeopleAsync();
    }
}
```
Metoda OnAppearing naplní CollectionView všemi daty uloženými v databázi. Metoda OnButtonClicked, která se spustí po klepnutí na Button, zadané údaje uloží do databáze před vymazáním obou instancí Entry a aktualizováním dat v objektu CollectionView.

Poznámka:

Přepsání metody OnAppearing se spustí až po rozložení ContentPage, ale těsně předtím, než se stane viditelným. Proto je to vhodné místo pro nastavení obsahu Xamarin.Forms zobrazení.
Na panelu nástrojů sady Visual Studio pro Mac stiskněte tlačítko Spustit (trojúhelníkové tlačítko, která se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném simulátoru iOSu nebo emulátoru Androidu.

Zadejte několik položek dat a pro každou z nich klepněte na Button. Tím se data uloží do databáze a CollectionView se znovu vyplní všemi databázovými daty:

V sadě Visual Studio pro Mac zastavte aplikaci.

Další informace o místních databázích naleznete v Xamarin.Formstématu Xamarin.Forms Místní databáze (průvodce)

Gratulujeme!

Zcela dokončeno!

Blahopřejeme k dokončení tohoto kurzu, ve kterém jste se naučili provádět tyto akce:

Pomocí Správce balíčků NuGet můžete do projektu přidat SQLite.NETXamarin.Forms.
Vytvořit třídy pro přístup k datům
Využití tříd pro přístup k datům

Další kroky

Další informace o základech vytváření mobilních aplikací najdete Xamarin.Formsv kurzu Webové služby.

Kurz webových služeb

Add SQLite.NET

Vytvořit třídy pro přístup k datům

Využít třídy pro přístup k datům

Gratulujeme!

Další kroky

Související odkazy