チュートリアル: Windows アプリでSQL Server データベースを使用する

アプリは SQL Server データベースに直接接続し、Microsoft.Data.SqlClient 名前空間のクラスを使用してデータを保存および取得できます。

作業の開始

このガイドでは、Windows アプリ SDKを使用するアプリでこれを行う 1 つの方法について説明します。 Northwind サンプルデータベースを SQL Server インスタンスにインストールし、これらのスニペットを使用すると、最終的に Northwind サンプルデータベースの製品を表示する基本的な UI が作成されます。

Northwind 製品

ヒント

Northwind および pubs サンプルデータベースを SQL Server Samples GitHub リポジトリから作成するスクリプトを取得することもできます。

このガイドに表示されるスニペットは、このサンプルアプリに基づいています。

まず、ソリューションをセットアップします。

アプリをSQL Server データベースに直接接続するには、Windows アプリ SDKでサポートされているWindowsの最小バージョンを対象にすることができます。プロジェクトのプロパティページにその情報があります。

マニフェストデザイナーで、Windows アプリ SDK プロジェクトの Package.appxmanifest ファイルを開きます。
現在の.NET プロジェクトテンプレート用の SQL クライアントパッケージをインストールします。 パッケージマネージャーコンソールで、Install-Package Microsoft.Data.SqlClientを実行します。
Capabilities タブで、SQL Serverの認証にWindows認証を使用している場合は、Enterprise Authentication チェックボックスをオンにします。

エンタープライズ認証機能

重要

また、Windows認証を使用しているかどうかに関係なく、Internet（クライアントおよびサーバー）、Internet（クライアント）、およびプライベートネットワーク（クライアントおよびサーバー）を選択する必要があります。

SQL Server データベースにデータを追加および取得する

このセクションでは、以下のことを行います。

1️⃣ 接続文字列を追加します。

2️⃣ 製品データを保持するクラスを作成します。

3️⃣ SQL Server データベースから製品を取得します。

4️⃣ 基本的なユーザーインターフェイスを追加します。

5️⃣ UI に製品を追加します。

注意

このセクションでは、データアクセスコードを編成する方法の 1 つを示します。これは、Microsoft.Data.SqlClient を使用して SQL Server データベースにデータを保存および取得する方法の例を示すことだけを目的としています。アプリケーションの設計に最も適した方法でコードを編成してください。

接続文字列を追加する

App.xaml.cs ファイルで、App クラスにプロパティを追加し、ソリューション内の他のクラスに接続文字列へのアクセス権を付与します。

接続文字列は、SQL Server Express インスタンス内の Northwind データベースを指します。このスニペットの接続文字列では、SQL Server Express のインストール時に既定のインスタンス名SQLEXPRESS を保持していることを前提としています。 SQL Server インスタンス、データベース、および認証方法に合わせて、接続文字列に変更を加えることができます。

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

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

    ...
}

重要

運用アプリケーションでは、接続情報をアプリ構成に安全に格納する必要があります (接続済みサービスを使用した Visual Studio Azure App Configurationの追加を参照)。接続文字列やその他のシークレットは、ハードコーディングしないでください。

この例接続文字列では、開発用のローカル SQL Server Express 証明書を信頼しています。運用環境で、検証可能なサーバー証明書をインストールし、 TrustServerCertificate=Falseを設定します。

製品データを保持するクラスを作成する

XAML UI でこのクラスのプロパティに属性をバインドできるように、INotifyPropertyChanged イベントを実装するクラスを作成します。

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));
    }
}

SQL Server データベースから製品を取得する

Windows アプリ SDK プロジェクトの MainWindow.xaml.cs ファイルで、Northwind サンプルデータベースから製品を取得し、それらを ObservableCollectionProduct インスタンスのコレクションとして返すメソッドを作成します。

using Microsoft.Data.SqlClient;

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;
}

基本的なユーザーインターフェイスを追加する

Windows アプリ SDK プロジェクトの MainWindow.xaml ファイルに次の XAML を追加します。

この XAML は、前のスニペットで返した各製品を表示する ListView を作成し、 ListView の各行の属性を、 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>

ListView で製品を表示する

MainWindow.xaml.cs ファイルを開き、ListView の ItemsSource プロパティを Product インスタンスの ObservableCollection に設定するMainWindow クラスのコンストラクターにコード追加します。

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

プロジェクトを開始すると、Northwind サンプルデータベースから取得した製品が UI に表示されます。

Northwind 製品

SQL Server データベース内のデータに対して他にどのようなことができるかを確認するには、Microsoft.Data.SqlClient 名前空間を参照してください。

ヒント

Microsoft Copilot に SQL クエリに関するヘルプを確認してみてください。 Copilotは、SQL クエリを記述し、コードを改善する方法を提案するのに役立ちます。

データベースへの接続で問題が発生した場合

ほとんどの場合、SQL Server構成の一部の側面を変更する必要があります。 Windows フォームやWPF アプリケーションなど、別の種類のデスクトップアプリケーションからデータベースに接続できる場合は、SQL Serverの TCP/IP が有効になっていることを確認します。これは、コンピューターの管理コンソールで行うことができます。 (詳細については、「Windows ツール/管理ツール」を参照してください)。

コンピューターの管理

次に、SQL Server Browser サービスが実行されていることを確認します。

SQL Server Browser サービス

次のステップ

Windows アプリで SQLite データベースを使用します

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-19