Přehled deklarací vazeb (WPF .NET)

  • Článek

Vývojáři obvykle deklarují vazby přímo v kódu XAML prvků uživatelského rozhraní, ke kterým chtějí svázat data. Můžete však také deklarovat vazby v kódu. Tento článek popisuje, jak deklarovat vazby v XAML i v kódu.

Předpoklady

Než si přečtete tento článek, je důležité, abyste se seznámili s konceptem a používáním rozšíření značek. Další informace o rozšířeních značek naleznete v tématu Rozšíření značek a WPF XAML.

Tento článek se nezabývá koncepty datových vazeb. Diskuzi o konceptech datových vazeb najdete v přehledu datových vazeb.

Deklarace vazby v XAML

Binding je rozšíření značek. Při použití rozšíření vazby deklarovat vazbu, deklarace se skládá z řady klauzulí za Binding klíčovým slovem a oddělené čárkami (,). Klauzule v deklaraci vazby mohou být v libovolném pořadí a existuje mnoho možných kombinací. Klauzule jsou páry Name=Value, kde Name je název Binding vlastnosti a Value je hodnota, kterou pro vlastnost nastavujete.

Při vytváření řetězců deklarací vazby v kódu musí být připojeny ke konkrétní vlastnosti závislosti cílového objektu. Následující příklad ukazuje, jak vytvořit vazbu TextBox.Text vlastnosti pomocí rozšíření vazby, Source určení a Path vlastnosti.

<TextBlock Text="{Binding Source={StaticResource myDataSource}, Path=Name}"/>

Většinu vlastností Binding třídy můžete zadat tímto způsobem. Další informace o rozšíření vazby a seznam Binding vlastností, které nelze nastavit pomocí rozšíření vazby, naleznete v přehledu Rozšíření značek vazby (.NET Framework).

Syntaxe elementu objektu

Syntaxe elementu objektu je alternativou k vytvoření deklarace vazby. Ve většině případů neexistuje žádná konkrétní výhoda použití rozšíření značek nebo syntaxe elementu objektu. Pokud však rozšíření značek nepodporuje váš scénář, například když je hodnota vlastnosti typu neřetězcový, pro který neexistuje žádný převod typu, musíte použít syntaxi elementu objektu.

Předchozí část ukazuje, jak vytvořit vazbu s rozšířením XAML. Následující příklad ukazuje stejnou vazbu, ale používá syntaxi elementu object:

<TextBlock>
    <TextBlock.Text>
        <Binding Source="{StaticResource myDataSource}" Path="Name"/>
    </TextBlock.Text>
</TextBlock>

Další informace o různých termínech najdete v tématu Podrobné informace o syntaxi XAML (.NET Framework).

MultiBinding a PriorityBinding

MultiBinding a PriorityBinding nepodporuje syntaxi rozšíření XAML. Proto je nutné použít syntaxi elementu objektu, pokud deklarujete MultiBinding nebo v PriorityBinding jazyce XAML.

Vytvoření vazby v kódu

Dalším způsobem, jak určit vazbu, je nastavit vlastnosti přímo u objektu Binding v kódu a pak přiřadit vazbu k vlastnosti. Následující příklad ukazuje, jak vytvořit Binding objekt v kódu.

private void Window_Loaded(object sender, RoutedEventArgs e)
{
    // Make a new data source object
    var personDetails = new Person()
    {
        Name = "John",
        Birthdate = DateTime.Parse("2001-02-03")
    };

    // New binding object using the path of 'Name' for whatever source object is used
    var nameBindingObject = new Binding("Name");

    // Configure the binding
    nameBindingObject.Mode = BindingMode.OneWay;
    nameBindingObject.Source = personDetails;
    nameBindingObject.Converter = NameConverter.Instance;
    nameBindingObject.ConverterCulture = new CultureInfo("en-US");

    // Set the binding to a target object. The TextBlock.Name property on the NameBlock UI element
    BindingOperations.SetBinding(NameBlock, TextBlock.TextProperty, nameBindingObject);
}

Private Sub Window_Loaded(sender As Object, e As RoutedEventArgs)

    ' Make a new data source object
    Dim personDetails As New Person() With {
        .Name = "John",
        .Birthdate = Date.Parse("2001-02-03")
    }

    ' New binding object using the path of 'Name' for whatever source object is used
    Dim nameBindingObject As New Binding("Name")

    ' Configure the binding
    nameBindingObject.Mode = BindingMode.OneWay
    nameBindingObject.Source = personDetails
    nameBindingObject.Converter = NameConverter.Instance
    nameBindingObject.ConverterCulture = New CultureInfo("en-US")

    ' Set the binding to a target object. The TextBlock.Name property on the NameBlock UI element
    BindingOperations.SetBinding(NameBlock, TextBlock.TextProperty, nameBindingObject)

End Sub

Předchozí kód nastavil na vazbu následující:

  • Cesta vlastnosti objektu zdroje dat.
  • Režim vazby.
  • V tomto případě je zdrojem dat jednoduchá instance objektu představující osobu.
  • Volitelný převaděč, který zpracovává hodnotu přicházející z objektu zdroje dat předtím, než je přiřazena k cílové vlastnosti.

Pokud je objekt, který používáte vazbu, FrameworkElement nebo FrameworkContentElementobjekt , můžete metodu SetBinding na objektu volat přímo namísto použití BindingOperations.SetBinding. Příklad najdete v tématu Postupy: Vytvoření vazby v kódu.

Předchozí příklad používá jednoduchý datový typ objektu Person. Následuje kód pro tento objekt:

class Person
{
    public string Name { get; set; }
    public DateTime Birthdate { get; set; }
}

Public Class Person

    Public Property Name As String
    Public Property Birthdate As DateTime
    
End Class

Syntaxe cesty vazby

Path Vlastnost použijte k určení zdrojové hodnoty, ke které chcete vytvořit vazbu:

  • V nejjednodušším případě Path je hodnota vlastnosti název vlastnosti zdrojového objektu, který se má použít pro vazbu, například Path=PropertyName.

  • Podproperties vlastnosti lze zadat podobnou syntaxí jako v jazyce C#. Klauzule Path=ShoppingCart.Order například nastaví vazbu na subproperty Order objektu nebo vlastnosti ShoppingCart.

  • Chcete-li vytvořit vazbu k připojené vlastnosti, umístěte závorky kolem připojené vlastnosti. Například pro vazbu k připojené vlastnosti DockPanel.Dock, syntaxe je Path=(DockPanel.Dock).

  • Indexery vlastnosti lze zadat v hranatých závorkách za názvem vlastnosti, ve které je použit indexer. Klauzule Path=ShoppingCart[0] například nastaví vazbu na index, který odpovídá tomu, jak interní indexování vlastnosti zpracovává literálový řetězec "0". Podporují se také vnořené indexery.

  • Indexery a dílčí podmínky můžou být v Path klauzuli smíšené, například Path=ShoppingCart.ShippingInfo[MailingAddress,Street].

  • Uvnitř indexerů. Můžete mít více parametrů indexeru oddělených čárkami (,). Typ každého parametru lze zadat pomocí závorek. Můžete Path="[(sys:Int32)42,(sys:Int32)24]"mít například , kde sys je namapován na System obor názvů.

  • Pokud je zdrojem zobrazení kolekce, lze aktuální položku zadat lomítkem (/). Klauzule Path=/ například nastaví vazbu na aktuální položku v zobrazení. Pokud je zdrojem kolekce, tato syntaxe určuje aktuální položku výchozího zobrazení kolekce.

  • Názvy a lomítka lze kombinovat a procházet vlastnosti, které jsou kolekcemi. Path=/Offices/ManagerName Například určuje aktuální položku zdrojové kolekce, která obsahuje Offices vlastnost, která je také kolekcí. Její aktuální položka je objekt, který obsahuje ManagerName vlastnost.

  • Volitelně lze použít cestu tečky (.) k vytvoření vazby k aktuálnímu zdroji. Například Text="{Binding}" je ekvivalentní s Text="{Binding Path=.}".

Mechanismus pro zapouzdření

  • Uvnitř indexerů ([ ]) znak stříšky (^) uvozuje další znak.

  • Pokud jste v jazyce XAML nastavili Path , musíte také uvést (pomocí entit XML) určité znaky, které jsou speciální pro definici jazyka XML:

    • Slouží &amp; k řídicímu znaku "&".

    • Slouží &gt; k úniku koncové značky ">".

  • Kromě toho, pokud popisujete celou vazbu v atributu pomocí syntaxe rozšíření značek, musíte řídicí znaky (pomocí zpětného lomítka \), které jsou speciální pro analyzátor rozšíření značek WPF:

    • Zpětné lomítko (\) je samotný řídicí znak.

    • Symbol rovná se (=) odděluje název vlastnosti od hodnoty vlastnosti.

    • Čárka (,) odděluje vlastnosti.

    • Pravá složená závorka (}) je konec rozšíření značek.

Směr vazby

Binding.Mode Pomocí vlastnosti zadejte směr vazby. Pro aktualizace vazeb jsou k dispozici následující režimy:

Režim vazby Popis
BindingMode.TwoWay Aktualizace cílovou vlastnost nebo vlastnost vždy, když se změní cílová vlastnost nebo zdrojová vlastnost.
BindingMode.OneWay Aktualizace cílovou vlastnost pouze v případech, kdy se zdrojová vlastnost změní.
BindingMode.OneTime Aktualizace cílovou vlastnost pouze při spuštění aplikace nebo při DataContext změně.
BindingMode.OneWayToSource Aktualizace zdrojové vlastnosti, když se cílová vlastnost změní.
BindingMode.Default Způsobí, že se použije výchozí Mode hodnota cílové vlastnosti.

Další informace naleznete v výčtu BindingMode .

Následující příklad ukazuje, jak nastavit Mode vlastnost:

<TextBlock Name="IncomeText" Text="{Binding Path=TotalIncome, Mode=OneTime}" />

Aby bylo možné zjistit změny zdroje (týkající se vazeb OneWay a TwoWay), musí zdroj implementovat vhodný mechanismus oznámení změny vlastnosti, jako je například INotifyPropertyChanged. Další informace najdete v tématu Poskytování oznámení o změnách.

U TwoWay nebo OneWayToSource vazby můžete řídit časování aktualizací zdroje nastavením UpdateSourceTrigger vlastnosti. Další informace najdete na webu UpdateSourceTrigger.

Výchozí chování

Výchozí chování je následující, pokud není zadáno v deklaraci:

  • Vytvoří se výchozí převaděč, který se pokusí provést převod typu mezi zdrojovou hodnotou vazby a cílovou hodnotou vazby. Pokud převod nelze provést, vrátí výchozí převaděč null.

  • Pokud nenastavíte ConverterCulture, modul vazeb použije Language vlastnost objektu binding target. V JAZYCE XAML se tato výchozí hodnota en-US nastaví nebo zdědí hodnotu z kořenového elementu (nebo jakéhokoli prvku) stránky, pokud byla explicitně nastavena.

  • Pokud již vazba obsahuje kontext dat (například zděděný kontext dat pocházející z nadřazeného prvku) a jakákoli položka nebo kolekce vrácená tímto kontextem je vhodná pro vazbu bez nutnosti další úpravy cesty, deklarace vazby nemusí mít vůbec žádné klauzule: {Binding}. To je často způsob, jakým je vazba určena pro styl dat, kde vazba působí na kolekci. Další informace naleznete v tématu Použití celých objektů jako zdroje vazby.

  • Výchozí hodnota Mode se liší mezi jednosměrnou a obousměrnou v závislosti na vlastnosti závislosti, která je vázána. Režim vazby můžete vždy deklarovat explicitně, abyste měli jistotu, že vaše vazba má požadované chování. Obecně platí, že uživatelsky upravitelné vlastnosti ovládacího prvku, například TextBox.Text a RangeBase.Value, výchozí pro obousměrné vazby, ale většina ostatních vlastností má výchozí jednosměrné vazby.

  • Výchozí UpdateSourceTrigger hodnota se liší mezi PropertyChanged vlastnostmi vázané závislosti a LostFocus v závislosti na vlastnosti vázané závislosti. Výchozí hodnota pro většinu vlastností závislosti je PropertyChanged, zatímco TextBox.Text vlastnost má výchozí hodnotu LostFocus.

Viz také