Extensão de marcação {Binding}

A extensão de marcação {Binding} é usada para associar propriedades de dados em controles a valores provenientes de uma fonte de dados, como código. A extensão de marcação {Binding} é convertida no tempo de carregamento XAML em uma instância da classe Binding . Esse objeto de vinculação obtém um valor de uma propriedade de uma fonte de dados e o transfere para a propriedade do controle. Opcionalmente, o objeto de associação pode ser configurado para observar alterações no valor da propriedade da fonte de dados e atualizar-se com base nessas alterações. Também pode, opcionalmente, ser configurado para propagar alterações no valor do controle de volta à propriedade de origem. A propriedade que é o destino de uma associação de dados deve ser uma propriedade de dependência. Para obter mais informações, consulte a visão geral das propriedades de dependência.

{Binding} tem a mesma precedência de propriedade de dependência que um valor local e definir um valor local no código imperativo remove o efeito de qualquer {Binding} definido na marcação.

Uso do atributo XAML

<object property="{Binding}" .../>
-or-
<object property="{Binding propertyPath}" .../>
-or-
<object property="{Binding bindingProperties}" .../>
-or-
<object property="{Binding propertyPath, bindingProperties}" .../>

Caminho da propriedade

Path descreve a propriedade à qual você está associando (a propriedade de origem). O caminho é um parâmetro posicional, o que significa que você pode usar o nome do parâmetro explicitamente ({Binding Path=EmployeeID}) ou especifique-o como o primeiro parâmetro sem nome ({Binding EmployeeID}).

O tipo de Path é um caminho de propriedade, ou seja, uma cadeia de caracteres que é resolvida como uma propriedade ou subpropriedade do seu tipo personalizado ou de um tipo de framework. O tipo pode ser, mas não precisa ser, um DependencyObject. Os passos em um caminho de propriedade são delimitados por pontos (.) e você pode incluir vários delimitadores para percorrer sucessivas subpropriedades. Use o delimitador de ponto independentemente da linguagem de programação usada para implementar o objeto ao qual está associado.

Por exemplo, para associar a interface do usuário à propriedade de nome de um objeto de funcionário, seu caminho de propriedade pode ser "Employee.FirstName". Se você estiver associando um controle de itens a uma propriedade que contenha os dependentes de um funcionário, seu caminho de propriedade poderá ser "Employee.Dependents" e o modelo de item do controle de itens cuidará da exibição dos itens em "Dependentes".

Se a fonte de dados for uma coleção, um caminho de propriedade poderá especificar itens na coleção por sua posição ou índice. Por exemplo, "Teams[0].Players", em que o literal "[]" delimita o "0", que especifica o primeiro elemento de uma coleção.

Ao usar uma associação ElementName a um DependencyObject existente, você pode usar propriedades anexadas como parte do caminho da propriedade. Para desambiguar uma propriedade anexada, de modo que o ponto intermediário no nome da propriedade anexada não seja considerado uma etapa de um caminho de propriedade, coloque parênteses ao redor do nome da propriedade anexada qualificado pelo proprietário; por exemplo, (AutomationProperties.Name).

Um objeto intermediário de um caminho de propriedade é armazenado como um objeto PropertyPath em uma representação de tempo de execução, mas, na maioria dos cenários, não será necessário interagir com um objeto PropertyPath no código. Normalmente, você pode especificar as informações de associação necessárias usando XAML.

Para obter mais informações sobre a sintaxe da cadeia de caracteres para um caminho de propriedade, os caminhos de propriedade em recursos de animação e sobre como construir um objeto PropertyPath, consulte Sintaxe de caminho de propriedade.

Propriedades da classe Binding que podem ser definidas com {Binding}

{Binding} é ilustrado com a sintaxe do placeholder bindingProperties porque várias propriedades de leitura e gravação de um Binding podem ser definidas na extensão de marcação. As propriedades podem ser definidas em qualquer ordem com pares devalor= separados por vírgulas. Algumas das propriedades exigem tipos que não têm conversão de tipo; por isso, exigem extensões de marcação específicas, aninhadas em {Binding}.

Converter, ConverterLanguage e ConverterLanguage estão todos relacionados ao cenário de conversão de um valor ou tipo da fonte de associação em um tipo ou valor compatível com a propriedade de destino de associação. Para obter mais informações e exemplos, consulte a seção "Conversões de dados" da associação de dados em profundidade.

Source, RelativeSource e ElementName especificam uma fonte de associação, portanto, são mutuamente exclusivas.

Exemplos

<!-- binding a UI element to a view model -->
<Page ... >
    <Page.DataContext>
        <local:BookstoreViewModel/>
    </Page.DataContext>

    <GridView ItemsSource="{Binding BookSkus}" SelectedItem="{Binding SelectedBookSku, Mode=TwoWay}" ... />
</Page>

<!-- binding a UI element to another UI element -->
<Page ... >
    <Page.Resources>
        <local:S2Formatter x:Key="GradeConverter"/>
    </Page.Resources>

    <Slider x:Name="sliderValueConverter" ... />
    <TextBox Text="{Binding Path=Value, ElementName=sliderValueConverter,
        Mode=OneWay,
        Converter={StaticResource GradeConverter}}"/>
</Page>

O segundo exemplo define quatro propriedades diferentes de Binding: ElementName, Path, Mode e Converter. Nesse caso, o caminho é mostrado explicitamente nomeado como uma propriedade Binding . O Path é avaliado como uma origem de vinculação de dados que é outro objeto na mesma árvore de objetos em tempo de execução, um Slider chamado sliderValueConverter.

Observe como o valor da propriedade Converter utiliza outra extensão de marcação, a extensão de marcação {StaticResource}, de modo que há duas extensões de marcação aninhadas aqui. O interno é avaliado primeiro, de modo que, depois que o recurso é obtido, há um IValueConverter prático (uma classe personalizada que é instanciada pelo local:S2Formatter elemento em recursos) que a associação pode usar.

Suporte a ferramentas

Microsoft IntelliSense no Microsoft Visual Studio exibe as propriedades do contexto de dados ao criar {Binding} no editor de marcação XAML. Assim que você digitar "{Binding", as propriedades do contexto de dados apropriadas para Path serão exibidas no menu suspenso. O IntelliSense também auxilia com as outras propriedades de Binding. Para que isso funcione, você deve ter definido na página de marcação o contexto de dados ou o contexto de dados em tempo de design. Go To Definition (F12) também funciona com {Binding}. Como alternativa, você pode usar a caixa de diálogo de associação de dados.