Compartilhar via


Como: Produzir um Valor com Base em uma Lista de Itens Vinculados

MultiBinding permite que você vincule uma propriedade de destino de vínculo a uma lista de propriedades da fonte e, então, aplique lógica para produzir um valor com as entradas disponíveis. Este exemplo demonstra como usar MultiBinding.

Exemplo

No exemplo a seguir, NameListData refere-se a uma coleção de objetos PersonName, que são objetos que contêm duas propriedades, firstName e lastName. O exemplo a seguir produz um TextBlock que mostra os nomes e sobrenomes de uma pessoa com o sobrenome em primeiro lugar.

<Window
  xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:c="clr-namespace:SDKSample"
  x:Class="SDKSample.Window1"
  Width="400"
  Height="280"
  Title="MultiBinding Sample">
    
  <Window.Resources>
    <c:NameList x:Key="NameListData"/>
    <c:NameConverter x:Key="myNameConverter"/>


...


</Window.Resources>


...


<TextBlock Name="textBox2" DataContext="{StaticResource NameListData}">
  <TextBlock.Text>
    <MultiBinding Converter="{StaticResource myNameConverter}"
                  ConverterParameter="FormatLastFirst">
      <Binding Path="FirstName"/>
      <Binding Path="LastName"/>
    </MultiBinding>
  </TextBlock.Text>
</TextBlock>


...


</Window>

Para entender como o formato é produzido, vamos dar uma olhada na implementação do NameConverter:

Public Class NameConverter
    Implements IMultiValueConverter

Public Function Convert1(ByVal values() As Object, _
                         ByVal targetType As System.Type, _
                         ByVal parameter As Object, _
                         ByVal culture As System.Globalization.CultureInfo) As Object _
                         Implements System.Windows.Data.IMultiValueConverter.Convert
    Select Case CStr(parameter)
        Case "FormatLastFirst"
            Return (values(1) & ", " & values(0))
    End Select
    Return (values(0) & " " & values(1))
End Function

Public Function ConvertBack1(ByVal value As Object, _
                             ByVal targetTypes() As System.Type, _
                             ByVal parameter As Object, _
                             ByVal culture As System.Globalization.CultureInfo) As Object() _
                             Implements System.Windows.Data.IMultiValueConverter.ConvertBack
    Return CStr(value).Split(New Char() {" "c})
End Function
End Class
public class NameConverter : IMultiValueConverter
{
    public object Convert(object[] values, Type targetType, object parameter, CultureInfo culture)
    {
        string name;

        switch ((string)parameter)
        {
            case "FormatLastFirst":
                name = values[1] + ", " + values[0];
                break;
            case "FormatNormal":
            default:
                name = values[0] + " " + values[1];
                break;
        }

        return name;
    }

    public object[] ConvertBack(object value, Type[] targetTypes, object parameter, CultureInfo culture)
    {
        string[] splitValues = ((string)value).Split(' ');
        return splitValues;
    }
}

NameConverter implementa o IMultiValueConverter interface. NameConverter usa os valores de vinculações individuais e os armazena na matriz de valores de objeto. A ordem na qual os elementos Binding aparecem sob o elemento MultiBinding é a ordem em que esses valores são armazenados no array. O valor do atributo ConverterParameter é referenciado pelo argumento do método Converter, que executa uma troca no parâmetro para determinar como formatar o nome.

For the complete sample, see Implementando parametrizado MultiBinding exemplo.

Consulte Demonstração de ligação de dados para um exemplo de uma implementação IMultiValueConverter.

Consulte também

Tarefas

Como: Converter Dados Acoplados

Conceitos

Revisão de Associação de Dados

Outros recursos

Exemplos de ligação de dados

Data Binding How-to Topics