Comment : spécifier la source de liaison
Dans la liaison de données, l'objet de source de liaison fait référence à l'objet dont vous obtenez vos données. Cette rubrique décrit les différentes manières de spécifier la source de liaison.
Exemple
Si vous liez plusieurs propriétés à une source commune, vous souhaitez utiliser la propriété DataContext, qui offre un moyen pratique d'établir une portée dans laquelle toutes les propriétés liées aux données héritent d'une source commune.
Dans l'exemple suivant, le contexte de données est établi à l'élément racine de l'application. Cela permet à tous les éléments enfants d'hériter de ce contexte de données. Les données pour la liaison viennent d'une classe de données personnalisée, NetIncome, référencée directement à travers un mappage et attribuée de la clé de ressource 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>
L'exemple suivant illustre la définition de la classe 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));
}
}
}
.gif "Remarque") Remarque |
|---|
L'exemple précité instancie l'objet dans la balise et l'utilise comme une ressource.Si vous souhaitez créer une liaison avec un objet qui a déjà été instancié dans le code, vous devez définir la propriété DataContext par programme.Pour obtenir un exemple, consultez Comment : rendre des données disponibles pour la liaison en XAML. |
Ou bien, si vous souhaitez spécifier explicitement la source sur vos liaisons individuelles, vous disposez des options suivantes. Celles-ci ont priorité sur le contexte de données hérité.
Propriété |
Description |
|---|---|
Vous utilisez cette propriété pour définir la source sur l'instance d'un objet. Si vous n'avez pas besoin des fonctionnalités d'établissement d'une portée dans laquelle plusieurs propriétés héritent du même contexte de données, vous pouvez utiliser la propriété Source au lieu de la propriété DataContext. Pour plus d'informations, consultez Source. |
|
C'est utile lorsque vous souhaitez spécifier la source relative à l'emplacement où se trouve votre cible de liaison. Quelques scénarios courants où vous pouvez utiliser cette propriété : lorsque vous souhaitez lier une propriété de votre élément à une autre propriété du même élément ou si vous définissez une liaison dans un style ou un modèle. Pour plus d'informations, consultez RelativeSource. |
|
Vous spécifiez une chaîne qui représente l'élément sur lequel vous souhaitez effectuer la liaison. C'est utile lorsque vous souhaitez créer une liaison avec la propriété d'un autre élément sur votre application. Par exemple, si vous souhaitez utiliser un Slider pour contrôler la hauteur d'un autre contrôle dans votre application, ou si vous voulez lier le Content de votre contrôle à la propriété SelectedValue de votre contrôle ListBox. Pour plus d'informations, consultez ElementName. |
Voir aussi
Référence
FrameworkContentElement.DataContext
Concepts
Héritage de la valeur de propriété
Vue d'ensemble de la liaison de données
Vue d'ensemble des déclarations de liaison