Freigeben über

Verwenden von Entwurfszeit-Beispieldaten mit dem XAML-Designer in Visual Studio

Einige datenabhängige Steuerelemente, z ListView. B. , ListBoxund DataGrid, sind schwer zu visualisieren, ohne Daten. In diesem Artikel werden wir einen neuen Ansatz überprüfen, mit dem Entwickler, die an .NET Core-Projekten (Windows Presentation Foundation, WPF) oder WPF .NET Framework-Projekten mit dem XAML-Designer in Visual Studio arbeiten, Beispieldaten in diesen Steuerelementen aktivieren können.

Anforderungen

Für das Feature "Beispieldaten" ist Visual Studio 2019, Version 16.10 oder höher, erforderlich. Das Feature unterstützt Windows-Desktopprojekte, die auf WPF für .NET Core oder .NET Framework abzielen, wenn Sie den neuen Designer verwenden.

Grundlagen des Features "Beispieldaten"

Das Feature "Beispieldaten" dient nur zur Entwurfszeitvisualisierung. Sie wird nur im XAML-Designer und nicht in der ausgeführten App angezeigt. Daher wird sie auf die Entwurfszeitversion der ItemsSource Eigenschaft d:ItemsSourceangewendet. Beispieldaten benötigen den Entwurfszeitnamespace, um zu funktionieren.

Hinweis

Weitere Informationen zu Entwurfszeiteigenschaften in XAML finden Sie unter XAML-Entwurfszeiteigenschaften.

Fügen Sie zunächst die folgenden Codezeilen zur Kopfzeile ihres XAML-Dokuments hinzu, wenn sie noch nicht vorhanden sind:

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

Nachdem Sie die Namespaces hinzugefügt haben, können d:ItemsSource="{d:SampleData}" Sie Beispieldaten in Ihrem ListView, Oder ListboxDataGrid Steuerelement aktivieren. Beispiel:

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

Screenshot, der Beispieldaten in einem Datenraster zeigt.

In diesem Beispiel d:ItemsSource="{d:SampleData}"ohne würde der XAML-Designer ein leeres Datenraster anzeigen. Stattdessen werden mit d:SampleDatadieser Nun generierte Standardbeispieldaten angezeigt.

Standardmäßig werden fünf Elemente angezeigt. Mit der ItemCount Eigenschaft können Sie jedoch angeben, wie viele Elemente angezeigt werden sollen. Beispiel: d:ItemsSource="{d:SampleData ItemCount=2}".

Beispieldaten mit Datenvorlagen

Das Beispieldatenfeature funktioniert für ListBox, ListViewoder DataGrid Steuerelemente, wenn Sie Datenvorlagen verwenden. Das Feature analysiert das DataTemplate Steuerelement und versucht, die entsprechenden Daten dafür zu generieren.

Beispieldaten werden nur für Elemente in Datenvorlagen generiert, die Bindungen verwenden. Beispieldaten werden auch dann generiert, wenn die Bindungen noch keine Quelle haben. Beispiel:

<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, der Beispieldaten in einer Listenansicht mit einer Datenvorlage zeigt.

Beispieldaten mit vorgeschlagenen Aktionen

Um Beispieldaten für ein Steuerelement aus dem Designer auf einfache Weise zu aktivieren oder zu deaktivieren, können Sie das Feature "Vorgeschlagene Aktionen" verwenden. Vorgeschlagene Aktionen sind eine Glühbirne auf dem Designer, die oben rechts angezeigt wird, wenn Sie ein Steuerelement auswählen. Sie können Beispieldaten aktivieren, indem Sie Ihr Steuerelement auswählen, die Glühbirne und dann " Beispieldaten anzeigen" auswählen. Beispiel:

Screenshot mit Beispieldaten mit

Beispieldaten mit der IValueConverter-Schnittstelle

Das Feature "Beispieldaten" unterstützt Konverter oder die IValueConverter Schnittstelle nicht vollständig. Sie können dies jedoch erreichen, indem Sie eine oder beide der folgenden Aktionen ausführen:

  • Stellen Sie sicher, dass Ihre Convert Funktion ein Szenario verarbeiten kann, in dem der Wert bereits Der Zieltyp ist.
  • Implementieren Sie die ConvertBack Funktion, die Ihren Wert wieder in den ursprünglichen Typ konvertiert.

Problembehandlung

Wenn Ihre Beispieldaten nichts anzeigen oder den richtigen Typ nicht anzeigen können, können Sie versuchen, den Designer zu aktualisieren oder die Seite zu schließen und erneut zu öffnen.

Wenn ein Problem auftritt, das nicht in diesem Abschnitt aufgeführt ist oder das nicht behoben werden kann, indem Sie die Seite aktualisieren, teilen Sie uns dies mit dem Tool " Problem melden " mit.

Verwandte Inhalte

  • Last updated on