データバインディングを作成する方法 (WPF .NET)

[アーティクル]
07/29/2024

この記事では、バインディング XAML を作成する方法について説明します。この例では、ある会社の 1 人の従業員を表すデータオブジェクトを使用します。このデータオブジェクトは XAML ウィンドウにバインドされており、TextBlock コントロールを使用してその従業員の詳細を一覧表示します。次の図のような UI を作成します。

ある従業員の詳細 (氏名、役職、採用日、給料など) を示す WPF のウィンドウ。

データバインディングの詳細については、WPF でのデータバインディングの概要に関するページを参照してください。

データオブジェクトを作成する

この例では、UI がバインドされているデータオブジェクトとして、従業員が使用されています。

プロジェクトに新しいクラスを追加して、Employee という名前を付けます。

コードを次のスニペットに置き換えます。

using System;
using System.ComponentModel;

namespace ArticleSample
{
    public class Employee : INotifyPropertyChanged
    {
        private decimal _salary;
        public event PropertyChangedEventHandler? PropertyChanged;

        public required string FirstName { get; set; }
        public required string LastName { get; set; }
        public required string Title { get; set; }
        public required DateTime HireDate { get; set; }

        public required decimal Salary
        {
            get => _salary;
            set
            {
                _salary = value;

                // Support TwoWay binding
                PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(nameof(Salary)));
            }
        }
    }
}

Imports System.ComponentModel

Public Class Employee
    Implements INotifyPropertyChanged

    Private _salary As Decimal
    Public Event PropertyChanged As PropertyChangedEventHandler Implements INotifyPropertyChanged.PropertyChanged

    Public Property FirstName As String
    Public Property LastName As String
    Public Property Title As String
    Public Property HireDate As DateTime

    Public Property Salary As Decimal
        Get
            Return _salary
        End Get
        Set(value As Decimal)
            _salary = value
            RaiseEvent PropertyChanged(Me, New PropertyChangedEventArgs(NameOf(Salary)))
        End Set
    End Property

End Class

従業員データオブジェクトは、ある従業員について説明するシンプルなクラスです。

その従業員の氏名。
その従業員の採用日。
その従業員の会社の役職。
その従業員の収入。

データオブジェクトにバインドする

次の XAML は、Employee クラスをデータオブジェクトとして使用するデモンストレーションを示します。ルート要素の DataContext プロパティは、XAML で宣言された静的なリソースにバインドされています。個々のコントロールは、Employee のプロパティにバインドされています。

プロジェクトに新しい Window を追加し、EmployeeView という名前を付けます

XAML を次のスニペットに置き換えます。

重要

次のスニペットは、C# プロジェクトからの抜粋です。 Visual Basic を使用している場合は、x:Class を ArticleSample 名前空間なしで宣言する必要があります。 Visual Basic バージョンがどのようになるかはこちらで確認できます。

<Window x:Class="ArticleSample.EmployeeView"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:ArticleSample"
        Title="" Height="250" Width="300">
    <Window.Resources>
        <local:Employee x:Key="EmployeeExample" FirstName="Niki" LastName="Demetriou"
                                                HireDate="2022-02-16" Salary="5012.00"
                                                Title="Content Artist" />
    </Window.Resources>
    <StackPanel DataContext="{StaticResource EmployeeExample}">
        <Label FontSize="32">Employee</Label>
        <Border BorderBrush="Gray" BorderThickness="2" />
        <Grid Grid.Row="1" Margin="5">
            <Grid.RowDefinitions>
                <RowDefinition Height="Auto"/>
                <RowDefinition Height="Auto"/>
                <RowDefinition Height="Auto"/>
                <RowDefinition Height="Auto"/>
                <RowDefinition Height="Auto"/>
            </Grid.RowDefinitions>
            <Grid.ColumnDefinitions>
                <ColumnDefinition Width="Auto"/>
                <ColumnDefinition Width="*"/>
            </Grid.ColumnDefinitions>

            <TextBlock Text="First Name:" Grid.Row="0" Margin="0,0,10,0" />
            <TextBlock Text="Last Name:" Grid.Row="1" />
            <TextBlock Text="Title:" Grid.Row="2" />
            <TextBlock Text="Hire Date:" Grid.Row="3" />
            <TextBlock Text="Salary" Grid.Row="4" />

            <TextBlock Text="{Binding FirstName}" Grid.Row="0" Grid.Column="1" />
            <TextBlock Text="{Binding LastName}" Grid.Row="1" Grid.Column="1" />
            <TextBlock Text="{Binding Title}" Grid.Row="2" Grid.Column="1" />
            <TextBlock Text="{Binding HireDate, StringFormat=d}" Grid.Row="3" Grid.Column="1" />
            <TextBlock Text="{Binding Salary, StringFormat=C0}" Grid.Row="4" Grid.Column="1" />
        </Grid>
        <Border BorderBrush="Gray" BorderThickness="2" />
        
        <StackPanel Margin="5,10" Orientation="Horizontal">
            <TextBlock Text="Change Salary:" Margin="0,0,10,0" />
            <TextBox Text="{Binding Salary, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged, StringFormat=C0}" Width="100" />
        </StackPanel>
    </StackPanel>
</Window>

ArticleSample という名前のプロジェクトを作成しない限り、コードの名前空間はプロジェクトの名前空間と一致しません。新しいプロジェクトを作成した場合は、Window.Resources とルート要素 (StackPanel) をコピーして、MainWindow に貼り付けることができます。

以前の XAML でデータバインディングがどのように使用されているかをより深く理解するために、次の点を考慮してください。

Employee クラスのインスタンスを作成するのに、XAML リソースが使用されています。

通常、データオブジェクトは Window に渡されるか、Window と関連付けられています。この例では、デモンストレーション目的で従業員がハードコードされています。
```
<Window.Resources>
    <local:Employee x:Key="EmployeeExample" FirstName="Niki" LastName="Demetriou"
                                            HireDate="2022-02-16" Salary="5012.00"
                                            Title="Content Artist" />
</Window.Resources>
```
ルート要素 (StackPanel) のデータコンテキストがハードコードされた Employee インスタンスに設定されています。

明示的に設定されていない限り、子要素は DataContext を親から継承します。
```
<StackPanel DataContext="{StaticResource EmployeeExample}">
```

Employee インスタンスのプロパティが TextBlock コントロールにバインドされています。

Binding では BindingSource が指定されないため、DataContext がソースとして使用されます。

<TextBlock Text="{Binding FirstName}" Grid.Row="0" Grid.Column="1" />
<TextBlock Text="{Binding LastName}" Grid.Row="1" Grid.Column="1" />
<TextBlock Text="{Binding Title}" Grid.Row="2" Grid.Column="1" />
<TextBlock Text="{Binding HireDate, StringFormat=d}" Grid.Row="3" Grid.Column="1" />
<TextBlock Text="{Binding Salary, StringFormat=C0}" Grid.Row="4" Grid.Column="1" />

TextBox コントロールが TwoWay モードでバインドされることで、TextBox で Employee.Salary プロパティを変更できます。
```
<TextBox Text="{Binding Salary, Mode=TwoWay, UpdateSourceTrigger=PropertyChanged, StringFormat=C0}" Width="100" />
```

データバインディングの概要

次の方法で共有

データバインディングを作成する方法 (WPF .NET)

データオブジェクトを作成する

データオブジェクトにバインドする

その他のリソース

次の方法で共有

データ バインディングを作成する方法 (WPF .NET)

データ オブジェクトを作成する

データ オブジェクトにバインドする

関連するコンテンツ

その他のリソース

データバインディングを作成する方法 (WPF .NET)

データオブジェクトを作成する

データオブジェクトにバインドする