Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Vissa layouter är svåra att visualisera utan data. I det här dokumentet granskar vi en av de metoder som utvecklare som arbetar med skrivbordsprojekt kan använda för att simulera data i XAML-designern. Denna metod använder det befintliga ignorerbara namnområdet "d:". Med den här metoden kan du snabbt lägga till designtidsdata på dina sidor eller kontroller utan att behöva skapa en fullständig modell av ViewModel, eller bara testa hur en egenskapsändring kan påverka ditt program utan att behöva oroa dig för att ändringarna påverkar versionsversionerna. Alla d:-data används endast av XAML Designer och inga ignorerbara namnområdesvärden kompileras in i applikationen.
Notera
Om du använder Xamarin.Forms kan du läsa Xamarin.Forms Design Time Data
Grundläggande om designtidsdata
Designtidsdata är falska data som du anger för att göra kontrollerna enklare att visualisera i XAML Designer. Kom igång genom att lägga till följande kodrader i rubriken för ditt XAML-dokument om de inte redan finns:
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d"
När du har lagt till namnrymderna kan du placera d: framför alla attribut eller kontroller för att visa det endast i XAML Designer men inte vid körning.
Du kan till exempel lägga till text i en TextBlock som vanligtvis har data som är bundna till den.
<TextBlock Text="{Binding Name}" d:Text="Name!" />
I det här exemplet skulle XAML-designern inte visa något för TextBlock utan d:Text. I stället visas "Namn!" där TextBlock kommer att ha verkliga data vid körning.
Du kan använda d: med attribut för alla UWP- eller WPF .NET Core-kontroller, till exempel färger, teckenstorlekar och avstånd. Du kan till och med lägga till den i själva kontrollen.
<d:Button Content="Design Time Button" />
I det här exemplet visas knappen bara vid designtillfället. Använd den här metoden för att placera en platshållare i för en anpassad kontroll eller för att prova olika kontroller. Alla d: attribut och kontroller ignoreras under körningen.
Förhandsgranska bilder vid designtillfället
Du kan ange en designtidskälla för bilder som är bundna till sidan eller som läses in dynamiskt. Lägg till den bild som du vill visa i XAML Designer i projektet. Du kan sedan visa den bilden i XAML Designer vid designtillfället:
<Image Source={Binding ProfilePicture} d:Source="DesignTimePicture.jpg" />
Notera
Bilden i det här exemplet måste finnas i lösningen.
Designtidsdata för ListViews
ListViews är ett populärt sätt att visa data i din skrivbordsapp. De är dock svåra att visualisera utan data. Du kan använda den här funktionen för att skapa en inline designtidsdata ItemSource eller objekt. XAML Designer visar vad som finns i matrisen i listvyn vid designtillfället.
WPF .NET Core-exempel
Om du vill använda system:Strängtyp måste du inkludera xmlns:system="clr-namespace:System;assembly=mscorlib i XAML-huvudet.
<StackPanel>
<ListView ItemsSource="{Binding Items}">
<d:ListView.ItemsSource>
<x:Array Type="{x:Type system:String}">
<system:String>Item One</system:String>
<system:String>Item Two</system:String>
<system:String>Item Three</system:String>
</x:Array>
</d:ListView.ItemsSource>
<ListView.ItemTemplate>
<DataTemplate>
<TextBlock Text="{Binding ItemName}" d:Text="{Binding .}" />
</DataTemplate>
</ListView.ItemTemplate>
</ListView>
</StackPanel>
I det här föregående exemplet visas en ListView med tre TextBlocks i XAML Designer.
Du kan också skapa en matris med dataobjekt. Offentliga egenskaper för ett City dataobjekt kan till exempel konstrueras som designtidsdata.
namespace Cities.Models
{
public class City
{
public string Name { get; set; }
public string Country { get; set; }
}
}
Om du vill använda klassen i XAML måste du importera namnområdet i rotnoden.
xmlns:models="clr-namespace:Cities.Models"
<StackPanel>
<ListView ItemsSource="{Binding Items}">
<d:ListView.ItemsSource>
<x:Array Type="{x:Type models:City}">
<models:City Name="Seattle" Country="United States"/>
<models:City Name="London" Country="United Kingdom"/>
<models:City Name="Panama City" Country="Panama"/>
</x:Array>
</d:ListView.ItemsSource>
<ListView.ItemTemplate>
<DataTemplate>
<StackPanel Orientation="Horizontal" >
<TextBlock Text="{Binding Name}" Margin="0,0,5,0" />
<TextBlock Text="{Binding Country}" />
</StackPanel>
</DataTemplate>
</ListView.ItemTemplate>
</ListView>
</StackPanel>
Fördelen här är att du kan binda dina kontroller till en statisk designtidsversion av din modell.
UWP-exempel
x:Array stöds inte i UWP. Därför kan vi använda <d:ListView.Items> i stället. Om du vill använda system:Strängtyp måste du inkludera http://schemas.microsoft.com/winfx/2009/xaml i XAML-huvudet.
<StackPanel>
<ListView>
<d:ListView.Items>
<system:String>Item One</system:String>
<system:String>Item Two</system:String>
<system:String>Item Three</system:String>
</d:ListView.Items>
</ListView>
</StackPanel>
Använda designtidsdata med anpassade typer och egenskaper
Den här funktionen fungerar som standard endast med plattformskontroller och egenskaper. I det här avsnittet går vi vidare med de steg som krävs för att du ska kunna använda dina egna anpassade kontroller som designtidskontroller, en ny funktion som är tillgänglig för kunder som använder Visual Studio 2019-versionen 16.8 eller senare. Det finns tre krav för att aktivera detta:
Ett anpassat xmlns-namnområde
xmlns:myControls="http://MyCustomControls"En version av ditt namnområde för designtid. Detta kan uppnås genom att helt enkelt lägga till /design i slutet.
xmlns:myDesignTimeControls="http://MyCustomControls/design"Lägga till designtidsprefixet i mc:Ignorable
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="d myDesignTimeControls"
När du har vidtagit alla dessa steg kan du använda ditt myDesignTimeControls-prefix för att skapa dina designtidskontroller.
<myDesignTimeControls:MyButton>I am a design time Button</myDesignTimeControls:MyButton>
Skapa ett anpassat xmlns-namnområde
Om du vill skapa ett anpassat xmlns-namnområde i WPF .NET Core måste du mappa ditt anpassade XML-namnområde till det CLR-namnområde som kontrollerna finns i. Du kan göra det genom att lägga till attributet på sammanställningsnivån XmlnsDefinition i filen AssemblyInfo.cs. Filen finns i rothierarkin i projektet.
[assembly: XmlnsDefinition("http://MyCustomControls", "MyViews.MyButtons")]
Felsökning
Om du stöter på ett problem som inte visas i det här avsnittet kan du meddela oss med hjälp av verktyget Rapportera ett problem.
XAML-designern slutade fungera
Försök att stänga och öppna XAML-filen igen och rensa och återskapa projektet.