Condividi tramite


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.

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.

Northwind products

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.

Aprire il file Package.appxmanifest del progetto Windows App SDK nella finestra di progettazione del manifesto.

Nella scheda Capacità seleziona la casella di controllo Autenticazione Enterprise se usi l'autenticazione di Windows per l'autenticazione di SQL Server.

Enterprise Authentication Capability

Importante

Dovrai anche selezionare Internet (client e server), Internet (client) e Reti private (client e server), indipendentemente dal fatto che sia in uso l'autenticazione di Windows.

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.

Nota

Questa sezione mostra un modo per organizzare il codice di accesso ai dati. Lo scopo è fornire un esempio di utilizzo di System.Data.SqlClient per archiviare e recuperare dati in un database SQL Server. Puoi organizzare il codice nel modo più appropriato per la progettazione dell'applicazione.

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.

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

    // This is an example connection string for using SQL Server Authentication.
    // private string connectionString =
    //     @"Data Source=YourServerName\YourInstanceName;Initial Catalog=DatabaseName; User Id=XXXXX; Password=XXXXX";

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

    ...
}

Importante

Nelle applicazioni di produzione, le informazioni di connessione devono essere archiviate in modo sicuro nella configurazione dell'app (vedere Aggiunta di Configurazione app di Azure tramite Servizi connessi di Visual Studio). Le stringhe di connessione e altri segreti non devono essere hard-coded.

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.

Northwind products

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.)

Computer Management

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

SQL Server Browser Service

Passaggi successivi

Usare un database leggero per archiviare i dati nel dispositivo degli utenti

Vedere Utilizzare un database SQLite in un'app di Windows.

Condividere il codice tra app diverse tra più piattaforme

Vedi Condividere codice tra un'app desktop e un'app UWP.

Aggiungere pagine master/dettagli con back-end SQL di Azure

Vedi l'esempio di database per gli ordini dei clienti.