方法 : バインディング ソースを指定する
データ バインディングでは、データの取得元のオブジェクトをバインディング ソース オブジェクトと呼びます。 ここでは、バインディング ソースを指定するさまざまな方法について説明します。
使用例
複数のプロパティを共通のソースにバインドする場合は、DataContext プロパティを使用することをお勧めします。このプロパティは、データ バインドされたすべてのプロパティが共通のソースから継承するスコープを確立するための便利な方法を提供します。
次の例では、アプリケーションのルート要素でデータ コンテキストが確立されています。 これにより、すべての子要素がデータ コンテキストを継承できます。 バインディングのデータは、カスタム データ クラス NetIncome をマッピングで直接参照し、リソース キーとして incomeDataSource を指定することによって取得しています。
<Grid
xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
x:Class="SDKSample.DirectionalBinding"
xmlns:c="clr-namespace:SDKSample"
Name="Page1"
>
<Grid.Resources>
<c:NetIncome x:Key="incomeDataSource"/>
<Style TargetType="{x:Type TextBlock}">
<Setter Property="Padding" Value="8"/>
</Style>
<Style TargetType="{x:Type TextBox}">
<Setter Property="Margin" Value="0,6,0,0"/>
</Style>
</Grid.Resources>
<Grid.DataContext>
<Binding Source="{StaticResource incomeDataSource}"/>
</Grid.DataContext>
...
</Grid>
NetIncome クラスの定義の例を次に示します。
Public Class NetIncome
Implements INotifyPropertyChanged
' Events
Public Event PropertyChanged As PropertyChangedEventHandler Implements INotifyPropertyChanged.PropertyChanged
' Methods
Public Sub New()
Me._totalIncome = 5000
Me._rent = 2000
Me._food = 0
Me._misc = 0
Me._savings = 0
Me._savings = (Me.TotalIncome - ((Me.Rent + Me.Food) + Me.Misc))
End Sub
Private Sub OnPropertyChanged(ByVal info As String)
RaiseEvent PropertyChanged(Me, New PropertyChangedEventArgs(info))
End Sub
Private Sub UpdateSavings()
Me.Savings = (Me.TotalIncome - ((Me.Rent + Me.Misc) + Me.Food))
If ((Me.Savings >= 0) AndAlso (Me.Savings >= 0)) Then
End If
End Sub
' Properties
Public Property Food As Integer
Get
Return Me._food
End Get
Set(ByVal value As Integer)
If (Me.Food <> value) Then
Me._food = value
Me.OnPropertyChanged("Food")
Me.UpdateSavings()
End If
End Set
End Property
Public Property Misc As Integer
Get
Return Me._misc
End Get
Set(ByVal value As Integer)
If (Me.Misc <> value) Then
Me._misc = value
Me.OnPropertyChanged("Misc")
Me.UpdateSavings()
End If
End Set
End Property
Public Property Rent As Integer
Get
Return Me._rent
End Get
Set(ByVal value As Integer)
If (Me.Rent <> value) Then
Me._rent = value
Me.OnPropertyChanged("Rent")
Me.UpdateSavings()
End If
End Set
End Property
Public Property Savings As Integer
Get
Return Me._savings
End Get
Set(ByVal value As Integer)
If (Me.Savings <> value) Then
Me._savings = value
Me.OnPropertyChanged("Savings")
Me.UpdateSavings()
End If
End Set
End Property
Public Property TotalIncome As Integer
Get
Return Me._totalIncome
End Get
Set(ByVal value As Integer)
If (Me.TotalIncome <> value) Then
Me._totalIncome = value
Me.OnPropertyChanged("TotalIncome")
End If
End Set
End Property
' Fields
Private _food As Integer
Private _misc As Integer
Private _rent As Integer
Private _savings As Integer
Private _totalIncome As Integer
End Class
public class NetIncome : INotifyPropertyChanged
{
private int totalIncome = 5000;
private int rent = 2000;
private int food = 0;
private int misc = 0;
private int savings = 0;
public NetIncome()
{
savings = totalIncome - (rent+food+misc);
}
public int TotalIncome
{
get
{
return totalIncome;
}
set
{
if( TotalIncome != value)
{
totalIncome = value;
OnPropertyChanged("TotalIncome");
}
}
}
public int Rent
{
get
{
return rent;
}
set
{
if( Rent != value)
{
rent = value;
OnPropertyChanged("Rent");
UpdateSavings();
}
}
}
public int Food
{
get
{
return food;
}
set
{
if( Food != value)
{
food = value;
OnPropertyChanged("Food");
UpdateSavings();
}
}
}
public int Misc
{
get
{
return misc;
}
set
{
if( Misc != value)
{
misc = value;
OnPropertyChanged("Misc");
UpdateSavings();
}
}
}
public int Savings
{
get
{
return savings;
}
set
{
if( Savings != value)
{
savings = value;
OnPropertyChanged("Savings");
UpdateSavings();
}
}
}
private void UpdateSavings()
{
Savings = TotalIncome - (Rent+Misc+Food);
if(Savings < 0)
{}
else if(Savings >= 0)
{}
}
public event PropertyChangedEventHandler PropertyChanged;
private void OnPropertyChanged(String info)
{
PropertyChangedEventHandler handler = PropertyChanged;
if (handler !=null)
{
handler(this, new PropertyChangedEventArgs(info));
}
}
}
メモ |
---|
上記の例では、マークアップ内のオブジェクトをインスタンス化し、リソースとして使用しています。コードで既にインスタンス化されているオブジェクトにバインドする場合は、DataContext プロパティをプログラムによって設定する必要があります。例については、「方法 : XAML でデータをバインディング可能にする」を参照してください。 |
また、個々のバインディングについてソースを明示的に指定する場合は、次のオプションを使用します。 これらは、継承されたデータ コンテキストより優先されます。
プロパティ |
説明 |
---|---|
このプロパティは、ソースをオブジェクトのインスタンスに設定するために使用します。 複数のプロパティが同じデータ コンテキストを継承するスコープを確立するという機能が必要でない場合は、Source プロパティを DataContext プロパティの代わりに使用できます。 詳細については、Source を参照してください。 |
|
これは、バインディング ターゲットの位置を基準にしてソースを指定する場合に役立ちます。 このプロパティを使用する可能性がある一般的なシナリオとしては、ある要素の特定のプロパティを同じ要素の別のプロパティにバインドする場合や、スタイルまたはテンプレートでバインディングを定義する場合などがあります。 詳細については、RelativeSource を参照してください。 |
|
バインド先の要素を表す文字列を指定します。 これは、アプリケーションの別の要素のプロパティにバインドする場合に役立ちます。 たとえば、Slider を使用してアプリケーション内の別のコントロールの高さを制御する場合や、コントロールの Content を ListBox コントロールの SelectedValue プロパティにバインドする場合に指定します。 詳細については、ElementName を参照してください。 |
参照
参照
FrameworkContentElement.DataContext