你的應用程式可以直接連接到 SQL Server 資料庫，然後透過 System.Data.SqlClient 命名空間中的類別來儲存和檢索資料。
開始使用
在本指南中，我們將展示一種在使用 Windows App SDK 的應用程式中實現的方法。 如果你把 Northwind 樣本資料庫安裝到你的 SQL Server 實例，然後使用這些片段，你會得到一個基本的介面，顯示來自 Northwind 樣本資料庫的產品。
提示
你也可以取得腳本，從 SQL Server Samples GitHub repository 建立 Northwind 和 pubs 樣本資料庫。
本指南中出現的片段是基於這個 UWP範例應用程式。
先設定解決方案
若要將應用程式直接連接到 SQL Server 資料庫，應用程式可以鎖定 Windows App SDK 支援的任何最低版本 Windows。 您可以在專案的屬性頁面中找到該資訊。
- 在 manifest designer 中開啟你Windows App SDK專案的 Package.appxmanifest 檔案。
- 在 Capabilities 標籤中，如果你使用 Windows 認證來驗證你的SQL Server，請勾選Enterprise Authentication勾選框。
重要
你還需要選擇 Internet（用戶端與;Server）、Internet（用戶端），以及 私有網路（用戶端與Server），不論你是否使用Windows認證。
在 SQL Server 資料庫中新增與檢索資料
本節中，我們會進行下列事項：
1️⃣ 新增一個 connection string。
2️⃣ 建立類別來保存產品資料。
3️��� 從 SQL Server 資料庫檢索產品。
4️⃣ 新增基本使用者介面。
5️⃣ 在 UI 中顯示產品。
注意
本節會說明資料存取碼的組織方式。 這只是想舉例說明如何使用
新增一個連接字串
在 App.xaml.cs 檔案中，為 App 類別新增一個屬性，讓解決方案中的其他類別能存取該 connection string。
我們的 connection string 指向 SQL Server Express 實例中的 Northwind 資料庫。 這段摘要中的 connection string 假設你安裝 SQL Server Express 時保留了預設實例名稱 SQLEXPRESS。 你可以修改 connection string，以符合你的 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";
public string ConnectionString { get => connectionString; set => connectionString = value; }
...
}
重要
在生產環境中，連線資訊應安全地儲存在應用程式設定中（參見 使用 Visual Studio Connected Services 添加Azure App Configuration）。 連接字串和其他祕密絕不可以硬式編碼。
建立類別來保留產品資料
我們會建立一個實作 INotifyPropertyChanged 事件的類別，這樣我們就能將 XAML UI 中的屬性綁定到這個類別的屬性。
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 App SDK專案的 MainWindow.xaml.cs 檔案中，建立一個方法，從 Northwind 樣本資料庫取得產品，然後以 ObservableCollection 集合回傳 Product 實例。
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;
}
新增基本使用者介面
將以下 XAML 加入 Windows App SDK 專案的 MainWindow.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 檔案，並在類別的MainWindow建構子中加入程式碼，將 ListView 的 ItemSource 屬性設定為實例的 Product。
public MainWindow()
{
this.InitializeComponent();
InventoryList.ItemsSource = GetProducts((App.Current as App).ConnectionString);
}
啟動專案，可在 UI 所顯示的 Northwind 範例資料庫中看到產品。
探索 System.Data.SqlClient 命名空間，看看你還能用SQL Server資料庫中的資料做些什麼。
提示
試著問 Microsoft Copilot 幫忙解答你的 SQL 查詢。 Copilot 可以幫助你撰寫 SQL 查詢，並建議改進程式碼的方法。
無法連線到您的資料庫？
在大多數情況下，SQL Server 設定的某些部分需要更改。 如果你能從其他類型的桌面應用程式（如 Windows Forms 或 WPF 應用程式）連接到資料庫，請確保你已啟用 SQL Server 的 TCP/IP。 你可以在 電腦管理 控制台裡操作。 （更多資訊請參見 Windows 工具/管理工具。）
接著，確保你的 SQL Server 瀏覽器服務正在運行。
