Sdílet prostřednictvím

Použití ukázkových dat v době návrhu v návrháři XAML v sadě Visual Studio

  • Článek

Některé ovládací prvky závislé na datech, jako ListViewje například , ListBoxa DataGrid, se obtížně vizualizují bez dat. V tomto článku si projdeme nový přístup, který vývojářům, kteří pracují na projektech WPF (Windows Presentation Foundation) nebo projektech WPF .NET Framework s Návrhářem XAML v sadě Visual Studio, umožní v těchto ovládacích prvcích ukázková data.

Požadavky

Funkce Ukázková data vyžaduje Visual Studio 2019 verze 16.10 nebo novější.

Tato funkce podporuje desktopové projekty Windows, které cílí na WPF pro .NET Core nebo .NET Framework při použití nového návrháře. Povolení nového návrháře pro rozhraní .NET Framework:

  1. Přejděte na Možnosti nástrojů>–>funkce prostředí>Ve verzi Preview.
  2. Vyberte Nový návrhář WPF XAML pro rozhraní .NET Framework a restartujte Visual Studio.

Základy funkce Ukázková data

Funkce Ukázková data je určená pouze pro vizualizaci v době návrhu. Zobrazí se jenom v návrháři XAML, ne ve spuštěné aplikaci. Proto se použije na verzi vlastnosti v době návrhu ItemsSourced:ItemsSource. Ukázková data potřebují k práci obor názvů v době návrhu.

Poznámka:

Další informace o vlastnostech návrhu v JAZYCE XAML najdete v tématu Vlastnosti návrhu XAML.

Začněte tím, že do záhlaví dokumentu XAML přidáte následující řádky kódu, pokud ještě nejsou k dispozici:

xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d"

Po přidání oborů názvů můžete použít d:ItemsSource="{d:SampleData}" k povolení ukázkových dat v ListViewobjektu , Listboxnebo DataGrid ovládacím prvku. Příklad:

<DataGrid d:ItemsSource="{d:SampleData}"/>

Screenshot that shows sample data on a data grid.

V tomto příkladu bez d:ItemsSource="{d:SampleData}"návrháře XAML by se zobrazila prázdná datová mřížka. d:SampleDataMísto toho teď zobrazuje vygenerovaná výchozí ukázková data.

Ve výchozím nastavení se zobrazí pět položek. Pomocí vlastnosti však můžete ItemCount určit, kolik položek chcete zobrazit. Například: d:ItemsSource="{d:SampleData ItemCount=2}".

Ukázková data pomocí šablon dat

Funkce Ukázková data funguje pro ListBox, ListViewnebo DataGrid ovládací prvky při použití šablon dat. Tato funkce analyzuje DataTemplate ovládací prvek a pokusí se pro něj vygenerovat příslušná data.

Ukázková data budou generována pouze pro prvky v šablonách dat, které používají vazby. Ukázková data se vygenerují i v případě, že vazby ještě nemají zdroj. Příklad:

<ListView d:ItemsSource="{d:SampleData ItemCount=3}">
     <ListView.ItemTemplate>
        <DataTemplate>
            <StackPanel Orientation="Horizontal">
                <Image Width="50" Source="{Binding ProfilePicture}"/>
                <StackPanel Orientation="Vertical">
                    <TextBlock Text="{Binding FirstName}" Margin="5"/>
                    <Label Content="{Binding LastName}"/>
                </StackPanel>
            </StackPanel>
        </DataTemplate>
    </ListView.ItemTemplate>
</ListView>

Screenshot that shows sample data in a list view with a data template.

Ukázková data s navrhovanými akcemi

K snadnému povolení nebo zakázání ukázkových dat pro ovládací prvek z návrháře můžete použít funkci Navrhované akce. Navrhované akce je žárovka v návrháři, který se zobrazí v pravém horním rohu při výběru ovládacího prvku. Ukázková data můžete povolit tak, že vyberete ovládací prvek, vyberete žárovku a pak vyberete Zobrazit ukázková data. Příklad:

Screenshot that shows sample data with Suggested Actions.

Ukázková data s rozhraním IValueConverter

Funkce Ukázková data plně nepodporuje převaděče ani IValueConverter rozhraní. Můžete to ale udělat tak, že uděláte jednu nebo obě z těchto věcí:

  • Ujistěte se, že vaše Convert funkce dokáže zpracovat scénář, ve kterém je hodnota již vaším cílovým typem.
  • ConvertBack Implementujte funkci, která převede hodnotu zpět na původní typ.

Řešení problému

Pokud se v ukázkových datech nic nezobrazuje nebo se nepodaří zobrazit správný typ, můžete zkusit aktualizovat návrháře nebo zavřít a znovu otevřít stránku.

Pokud narazíte na problém, který není uvedený v tomto oddílu nebo který nejde opravit aktualizací stránky, dejte nám prosím vědět pomocí nástroje Nahlásit problém .

Související obsah