Visual Studio XAML Tasarımcısı tasarım zamanı örnek verilerini kullanın

  • Makale
  • Okumak için 2 dakika

, Ve gibi veri tabanlı bazı denetimlerin ListView ListBox DataGrid veri olmadan görselleştirilmesi zordur. bu makalede, bu denetimlerde örnek verileri etkinleştirmek için Windows Presentation Foundation (WPF) .net Core projelerinde veya wpf .NET Framework projelerinde çalışan geliştiricilerin Visual Studio içindeki XAML Tasarımcısı olan yeni bir yaklaşımı gözden geçireceğiz.

Gereksinimler

örnek veri özelliği Visual Studio 2019 sürüm 16,10 veya üstünü gerektirir.

özelliği, yeni tasarımcıyı kullanırken .net Core veya .NET Framework için WPF 'yi hedefleyen Windows masaüstü projelerini destekler. .NET Framework için yeni tasarımcıyı etkinleştirmek için:

  1. Araçlar > Seçenekler > ortam > Önizleme özellikleri' ne gidin.
  2. .NET Framework için yeni WPF XAML Tasarımcısı seçin ve Visual Studio yeniden başlatın.

Örnek veri özelliğinin temelleri

Örnek veri özelliği yalnızca tasarım zamanı görselleştirmedir. Yalnızca XAML tasarımcısında görünür, çalışan uygulamada değil. Bu nedenle, özelliğin tasarım zamanı sürümüne uygulanır ItemsSource d:ItemsSource . Örnek veriler için tasarım zamanı ad alanının çalışması gerekir.

Not

XAML 'de tasarım zamanı özellikleri hakkında daha fazla bilgi edinmek için bkz. XAML tasarım zamanı özellikleri.

Başlamak için, zaten mevcut değilse XAML belgenizin üstbilgisine aşağıdaki kod satırlarını ekleyin:

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

Ad alanlarını ekledikten sonra, d:ItemsSource="{d:SampleData}" veya denetimindeki örnek verileri etkinleştirmek için kullanabilirsiniz ListView Listbox DataGrid . Örnek:

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

Veri kılavuzunda örnek verileri gösteren ekran görüntüsü.

Bu örnekte, olmadan d:ItemsSource="{d:SampleData}" XAML Tasarımcısı boş bir veri kılavuzu gösterecektir. Bunun yerine, d:SampleData artık oluşturulan varsayılan örnek verileri gösterir.

Varsayılan olarak, beş öğe görüntülenir. Ancak, ItemCount özelliğini kullanarak kaç öğe görüntülenmesini istediğinizi belirtebilirsiniz. Örneğin: d:ItemsSource="{d:SampleData ItemCount=2}".

Veri şablonlarıyla örnek veriler

Örnek veri özelliği ListBox , ListView DataGrid veri şablonlarını kullandığınızda, veya denetimleri için geçerlidir. Özellik denetimi analiz eder DataTemplate ve uygun verileri oluşturmaya çalışır.

Örnek veriler, yalnızca bağlamaları kullanan veri şablonlarındaki öğeler için oluşturulur. Bağlamaların henüz bir kaynağı olmasa bile örnek veriler oluşturulacaktır. Örnek:

<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>

Veri şablonuyla bir liste görünümünde örnek verileri gösteren ekran görüntüsü.

Önerilen eylemlerle örnek veriler

Tasarımcıdan bir denetim için örnek verileri kolayca etkinleştirmek veya devre dışı bırakmak için Önerilen Eylemler özelliğini kullanabilirsiniz. Önerilen Eylemler, bir denetim seçtiğinizde sağ üst köşede görüntülenen, tasarımcı üzerinde yer alan bir ampul olur. Denetiminizi seçip ampul ' i seçip örnek verileri göster' i seçerek örnek verileri etkinleştirebilirsiniz. Örnek:

Önerilen eylemlerle örnek verileri gösteren ekran görüntüsü.

IValueConverter arabirimiyle örnek veriler

Örnek veri özelliği, dönüştürücüleri veya arabirimi tam olarak desteklemez IValueConverter . Bununla birlikte, aşağıdakilerden birini veya her ikisini yaparak çalışmasını sağlayabilirsiniz:

  • Convertİşlevinizin, değerin zaten hedef türü olduğu bir senaryoyu işleyebildiği şekilde emin olun.
  • ConvertBackDeğeri özgün türe geri dönüştürecek işlevi uygulayın.

Sorun giderme

Örnek verileriniz herhangi bir şeyi göstermiyorsa veya doğru türü göstermiyorsa, tasarımcıyı yenilemeyi veya sayfayı kapatıp yeniden açmayı deneyebilirsiniz.

Bu bölümde listelenmeyen veya sayfa yenilenerek düzeltimeyen bir sorunla karşılaşırsanız lütfen sorun bildir aracını kullanarak bize bildirin.

Ayrıca bkz.