Usare un database di SQL Server in un'app di Windows

L'app può connettersi direttamente a un database SQL Server e quindi archiviare e recuperare dati usando le classi dello spazio dei nomi System.Data.SqlClient.

Introduzione

In questa guida verrà illustrato un modo per farlo nelle app di Windows App SDK. Se installi il database di esempio Northwind nell'istanza di SQL Server e quindi usi questi frammenti di codice, otterrai un'interfaccia utente di base che mostra i prodotti contenuti in tale database.

I frammenti di codice visualizzati in questa guida sono basati su questa app di esempio UWP.

Innanzitutto configura la soluzione

Per connettere l'app direttamente a un database del server SQL, l'app può avere come destinazione qualsiasi versione minima di Windows supportata da Windows App SDK. Puoi trovare queste informazioni nella pagina delle proprietà del progetto.

1. Aprire il file Package.appxmanifest del progetto Windows App SDK nella finestra di progettazione del manifesto.
2. Nella scheda Capacità seleziona la casella di controllo Autenticazione Enterprise se usi l'autenticazione di Windows per l'autenticazione di SQL Server.

Aggiungere e recuperare dati di un database SQL Server

In questa sezione eseguiremo queste operazioni:

1️⃣ Aggiungere una stringa di connessione.

2️⃣ Creare una classe per contenere i dati del prodotto.

3️⃣ Recuperare i prodotti dal database di SQL Server.

4️⃣ Aggiungere un'interfaccia utente di base.

5️⃣ Popolare l'interfaccia utente con i prodotti.

Aggiungere una stringa di connessione

Nel file App.xaml.cs aggiungi una proprietà alla classe App, che fornisce alle altre classi della soluzione l'accesso alla stringa di connessione.

La nostra stringa di connessione punta al database Northwind in un'istanza di SQL Server Express. Il stringa di connessione in questo frammento presuppone che il nome SQLEXPRESS dell'istanza predefinito sia stato mantenuto durante l'installazione di SQL Server Express. È possibile apportare modifiche al stringa di connessione in modo che corrispondano all'istanza di SQL Server, al database e al metodo di autenticazione.

sealed partial class App : Application
{
    // Connection string for using Windows Authentication.
    private string connectionString =
        @"Data Source=.\SQLEXPRESS;Initial Catalog=NORTHWIND;Integrated Security=SSPI";

    public string ConnectionString { get => connectionString; set => connectionString = value; }

    ...
}

Creare una classe per contenere i dati dei prodotti

Creeremo una classe che implementa l'evento INotifyPropertyChanged in modo da poter associare gli attributi nell'interfaccia utente XAML alle proprietà di questa classe.

public class Product : INotifyPropertyChanged
{
    public int ProductID { get; set; }
    public string ProductCode { get { return ProductID.ToString(); } }
    public string ProductName { get; set; }
    public string QuantityPerUnit { get; set; }
    public decimal UnitPrice { get; set; }
    public string UnitPriceString { get { return UnitPrice.ToString("######.00"); } }
    public int UnitsInStock { get; set; }
    public string UnitsInStockString { get { return UnitsInStock.ToString("#####0"); } }
    public int CategoryId { get; set; }

    public event PropertyChangedEventHandler PropertyChanged;
    private void NotifyPropertyChanged(string propertyName)
    {
        PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
    }
}

Recuperare i prodotti dal database SQL Server

Nel file MainWindow.xaml.cs del progetto Windows App SDK creare un metodo che ottiene i prodotti dal database di esempio Northwind e quindi li restituisce come raccolta ObservableCollection di Product istanze.

public ObservableCollection<Product> GetProducts(string connectionString)
{
    const string GetProductsQuery = "select ProductID, ProductName, QuantityPerUnit," +
       " UnitPrice, UnitsInStock, Products.CategoryID " +
       " from Products inner join Categories on Products.CategoryID = Categories.CategoryID " +
       " where Discontinued = 0";

    var products = new ObservableCollection<Product>();
    try
    {
        using (var conn = new SqlConnection(connectionString))
        {
            conn.Open();
            if (conn.State == System.Data.ConnectionState.Open)
            {
                using (SqlCommand cmd = conn.CreateCommand())
                {
                    cmd.CommandText = GetProductsQuery;
                    using (SqlDataReader reader = cmd.ExecuteReader())
                    {
                        while (reader.Read())
                        {
                            var product = new Product();
                            product.ProductID = reader.GetInt32(0);
                            product.ProductName = reader.GetString(1);
                            product.QuantityPerUnit = reader.GetString(2);
                            product.UnitPrice = reader.GetDecimal(3);
                            product.UnitsInStock = reader.GetInt16(4);
                            product.CategoryId = reader.GetInt32(5);
                            products.Add(product);
                        }
                    }
                }
            }
        }
        return products;
    }
    catch (Exception eSql)
    {
        Debug.WriteLine($"Exception: {eSql.Message}");
    }
    return null;
}

Aggiungere un'interfaccia utente di base

Aggiungere il codice XAML seguente al file MainWindow.xaml del progetto Windows App SDK.

Questo codice XAML crea una ListView per mostrare ogni prodotto restituito nel frammento precedente e associa gli attributi di ogni riga nel ListView alle proprietà definite nella classe Product.

<Grid Background="{ThemeResource SystemControlAcrylicWindowBrush}">
    <RelativePanel>
        <ListView Name="InventoryList"
                  SelectionMode="Single"
                  ScrollViewer.VerticalScrollBarVisibility="Auto"
                  ScrollViewer.IsVerticalRailEnabled="True"
                  ScrollViewer.VerticalScrollMode="Enabled"
                  ScrollViewer.HorizontalScrollMode="Enabled"
                  ScrollViewer.HorizontalScrollBarVisibility="Auto"
                  ScrollViewer.IsHorizontalRailEnabled="True"
                  Margin="20">
            <ListView.HeaderTemplate>
                <DataTemplate>
                    <StackPanel Orientation="Horizontal"  >
                        <TextBlock Text="ID" Margin="8,0" Width="50" Foreground="DarkRed" />
                        <TextBlock Text="Product description" Width="300" Foreground="DarkRed" />
                        <TextBlock Text="Packaging" Width="200" Foreground="DarkRed" />
                        <TextBlock Text="Price" Width="80" Foreground="DarkRed" />
                        <TextBlock Text="In stock" Width="80" Foreground="DarkRed" />
                    </StackPanel>
                </DataTemplate>
            </ListView.HeaderTemplate>
            <ListView.ItemTemplate>
                <DataTemplate x:DataType="local:Product">
                    <StackPanel Orientation="Horizontal" >
                        <TextBlock Name="ItemId"
                                    Text="{x:Bind ProductCode}"
                                    Width="50" />
                        <TextBlock Name="ItemName"
                                    Text="{x:Bind ProductName}"
                                    Width="300" />
                        <TextBlock Text="{x:Bind QuantityPerUnit}"
                                   Width="200" />
                        <TextBlock Text="{x:Bind UnitPriceString}"
                                   Width="80" />
                        <TextBlock Text="{x:Bind UnitsInStockString}"
                                   Width="80" />
                    </StackPanel>
                </DataTemplate>
            </ListView.ItemTemplate>
        </ListView>
    </RelativePanel>
</Grid>

Mostrare i prodotti nel controllo ListView

Aprire il file MainWindow.xaml.cs e aggiungere il codice al costruttore della classe MainWindow che imposta la proprietà ItemSource di ListView alla ObservableCollection delle istanze di Product.

public MainWindow()
{
    this.InitializeComponent();
    InventoryList.ItemsSource = GetProducts((App.Current as App).ConnectionString);
}

Avvia il progetto: i prodotti del database di esempio Northwind vengono visualizzati nell'interfaccia utente.

Esplora lo spazio dei nomi System.Data.SqlClient per scoprire cos'altro puoi fare con i dati del database SQL Server.

Problemi di connessione al database?

Nella maggior parte dei casi, alcuni aspetti della configurazione di SQL Server devono essere modificati. Se sei in grado di collegarti al tuo database da un altro tipo di applicazione desktop, ad esempio un'applicazione Windows Form o WPF, assicurati di aver abilitato TCP/IP per SQL Server. Puoi effettuare questo controllo nella console Gestione computer. (Vedere Strumenti di Windows/Strumenti di amministrazione per altre informazioni.)

Quindi, assicurati che sia in esecuzione il servizio SQL Server Browser.

Passaggio successivo