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

Některé ovládací prvky, jako ListView ListBox jsou, a, DataGrid je obtížné vizualizovat bez dat. v tomto článku si probereme nový přístup, který umožňuje vývojářům, kteří pracují na projektech Windows Presentation Foundation (wpf) .net Core nebo v projektech wpf .NET Framework, Návrhář XAML v Visual Studio k povolení ukázkových dat v těchto ovládacích prvcích.

Požadavky

funkce vzorových dat vyžaduje Visual Studio 2019 verze 16,10 nebo novější.

tato funkce podporuje Windows desktopové projekty, které cílí na technologii WPF pro .net Core nebo .NET Framework při použití nového návrháře. Chcete-li povolit nového návrháře pro .NET Framework:

  1. V nabídce nástroje > Možnosti > prostředí > verze Preview.
  2. vyberte nový Návrhář XAML WPF pro .NET Framework a pak restartujte Visual Studio.

Základy funkce vzorových dat

Funkce vzorových dat je určena pouze pro vizualizaci v době návrhu. Zobrazí se pouze v Návrháři XAML, nikoli ve spuštěné aplikaci. V takovém případě se použije na verzi vlastnosti v době návrhu ItemsSource d:ItemsSource . Ukázková data vyžadují, aby obor názvů návrhu fungoval.

Poznámka

Další informace o vlastnostech v době návrhu v jazyce XAML naleznete v tématu vlastnosti doby návrhu XAML.

Chcete-li začít, přidejte následující řádky kódu do záhlaví dokumentu jazyka XAML, 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 ListView Listbox DataGrid ovládacím prvku, nebo. Například:

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

Snímek obrazovky zobrazující ukázková data pro datovou mřížku

V tomto příkladu, bez d:ItemsSource="{d:SampleData}" Návrhář XAML, by zobrazila prázdnou datovou mřížku. Místo toho se d:SampleData nyní zobrazuje vygenerovaná výchozí ukázková data.

Ve výchozím nastavení se zobrazí pět položek. Můžete však použít ItemCount vlastnost k určení, kolik položek chcete zobrazit. Příklad: d:ItemsSource="{d:SampleData ItemCount=2}".

Ukázková data pomocí datových šablon

Funkce ukázková data funguje pro ListBox ListView DataGrid ovládací prvky, nebo při použití datových šablon. Funkce provede analýzu DataTemplate ovládacího prvku a pokusí se pro něj vygenerovat vhodná data.

Vzorová data budou generována pouze pro prvky v datových šablonách, které používají vazby. Vzorová data budou generována i v případě, že vazby ještě nemají zdroj. Napří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>

Snímek obrazovky, který zobrazuje ukázková data v zobrazení seznamu s datovou šablonou.

Ukázková data s navrhovanými akcemi

Chcete-li snadno povolit nebo zakázat ukázková data pro ovládací prvek z návrháře, můžete použít funkci navrhovaných akcí. Navrhované akce jsou žárovky v návrháři, který se zobrazí v pravém horním rohu při výběru ovládacího prvku. Můžete povolit ukázková data tak, že vyberete ovládací prvek, vyberete žárovky a pak vyberete Zobrazit Ukázková data. Například:

Snímek obrazovky zobrazující ukázková data s navrhovanými akcemi

Ukázková data s rozhraním metodě IValueConverter

Funkce ukázková data nepodporují převaděče nebo IValueConverter rozhraní. Můžete ji ale využít k tomu, že uděláte jednu z následujících možností:

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

Řešení potíží

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

Pokud se setkáte s problémem, který není uvedený v této části, nebo ho nelze opravit aktualizací stránky, dejte nám prosím informace pomocí nástroje nahlásit problém .

Viz také