Utiliser une base de données SQL Server dans une application Windows
Votre application peut se connecter directement à une base de données SQL Server, puis stocker et récupérer des données à l’aide de classes de l’espace de noms System.Data.SqlClient.
Mise en route
Dans ce guide, nous allons vous montrer une façon de procéder ainsi dans vos applications SDK d’application Windows. Si vous installez la base de données exemple Northwind sur votre instance de SQL Server, puis que vous utilisez ces extraits de code, vous obtiendrez une interface utilisateur de base qui montre les produits de la base de données exemple.
Conseil
Vous pouvez également obtenir des scripts pour créer les exemples de bases de données Northwind et pubs à partir du dépôt GitHub des exemples SQL Server.
Les extraits de code qui s’affichent dans ce guide se basent sur cet exemple d’application UWP.
Tout d’abord, configurez votre solution.
Pour connecter votre application directement à une base de données SQL Server, votre application peut cibler n’importe quelle version minimale de Windows prise en charge par le SDK d’application Windows. Vous trouverez ces informations dans la page de propriétés de votre projet.
- Dans le concepteur de manifeste, ouvrez le fichier Package.appxmanifest du projet SDK d’application Windows.
- Dans l’onglet Fonctionnalités, cochez la case Authentification d’entreprise si vous utilisez l’authentification Windows pour authentifier votre serveur SQL Server.
Important
Vous devrez aussi sélectionner Internet (client et serveur), Internet (client) et Réseaux privés (client et serveur), que vous utilisiez ou non l’authentification Windows.
Ajouter et récupérer des données dans une base de données SQL Server
Dans cette section, nous allons effectuer les opérations suivantes :
1️⃣ Ajouter une chaîne de connexion.
2️⃣ Créer une classe pour contenir des données sur les produits.
3️⃣ Récupérer les produits à partir de la base de données SQL Server.
4️⃣ Ajouter une interface utilisateur de base.
5️⃣ Remplir l’interface utilisateur avec des produits.
Notes
Cette section illustre une façon d’organiser votre code d’accès aux données. Vous y trouverez un exemple illustrant la façon dont vous pouvez utiliser System.Data.SqlClient pour stocker et récupérer des données à partir d’une base de données SQL Server. Vous pouvez organiser votre code d’une manière plus appropriée pour la conception de votre application.
Ajouter une chaîne de connexion
Dans le fichier App.xaml.cs, ajoutez une propriété à la classe App qui permet aux autres classes de votre solution d’accéder à la chaîne de connexion.
Notre chaîne de connexion pointe vers la base de données Northwind sur une instance de SQL Server Express. La chaîne de connexion dans cet extrait de code suppose que vous avez conservé le nom SQLEXPRESS de l’instance par défaut lors de l’installation de SQL Server Express. Vous pouvez apporter des modifications au chaîne de connexion pour correspondre à votre instance, base de données et méthode d’authentification 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; }
...
}
Important
Dans les applications de production, les informations de connexion doivent être stockées de manière sécurisée dans la configuration de l’application (consultez Ajout d’Azure App Configuration à l’aide de Visual Studio Connected Services). Les chaînes de connexion et autres secrets ne doivent jamais être codés en dur.
Créer une classe pour contenir des données sur les produits
Nous allons créer une classe qui implémente l’événement INotifyPropertyChanged pour pouvoir lier des attributs de notre interface utilisateur XAML aux propriétés de cette 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));
}
}
Récupérer les produits à partir de la base de données SQL Server
Dans le fichier MainWindow.xaml.cs du projet SDK d’application Windows, créez une méthode qui obtient des produits à partir de l’exemple de base de données Northwind, puis les retourne sous la forme d’une collection ObservableCollection d’instances 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;
}
Ajouter une interface utilisateur de base
Ajoutez le code XAML suivant au fichier MainWindow.xaml du projet SDK d’application Windows.
Ce code XAML crée un ListView pour afficher chaque produit renvoyé dans l’extrait de code précédent et lie les attributs de chaque ligne dans le ListView aux propriétés que nous avons définies dans la 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>
Afficher les produits dans le contrôle ListView
Ouvrez le fichier MainWindow.xaml.cs et ajoutez du code au constructeur de la classe MainWindow qui définit la propriété ItemSource de l’élément ListView sur la collection ObservableCollection des instances Product.
public MainWindow()
{
this.InitializeComponent();
InventoryList.ItemsSource = GetProducts((App.Current as App).ConnectionString);
}
Démarrez le projet pour afficher les produits de la base de données exemple Northwind dans l’interface utilisateur.
Explorez l’espace de noms System.Data.SqlClient pour voir les autres actions que vous pouvez effectuer avec les données dans votre base de données SQL Server.
Conseil
Essayez de demander à Microsoft Copilot d’obtenir de l’aide sur vos requêtes SQL. Copilot peut vous aider à écrire des requêtes SQL et à suggérer des façons d’améliorer votre code.
Problèmes de connexion à votre base de données ?
Dans la plupart des cas, certains aspects de la configuration de SQL Server doivent être modifiés. Si vous pouvez vous connecter à votre base de données à partir d’un autre type d’application de bureau, comme une application Windows Forms ou WPF, assurez-vous que vous avez activé TCP/IP pour SQL Server. Vous pouvez le faire dans la console Gestion de l’ordinateur. (Pour plus d’informations, consultez Outils Windows/Outils d’administration.)
Ensuite, assurez-vous que votre service SQL Server Browser est en cours d’exécution.
Étape suivante
Windows developer