Partager via

Attributs au moment du design

  • Article

Lorsque vous générez des applications WPF ou Silverlight à l'aide du Concepteur WPF pour Visual Studio, vous avez parfois besoin de fournir des informations pour que le mode Design fonctionne correctement. Vous spécifiez ce genre d'informations à l'aide d'attributs au moment du design. Ainsi, les attributs au moment du design permettent le dimensionnement de la fenêtre racine avec des valeurs spécifiques pour s'adapter à la conception de disposition, tout en conservant le dimensionnement lié au contenu au moment de l'exécution. Les attributs au moment du design sont ignorés pendant la compilation et n'ont aucun effet au moment de l'exécution.

Attributs au moment du design

Le Concepteur WPF fournit les attributs au moment du design suivants.

Attribut au moment du design

Description

Exemple d'utilisation

d:DesignHeight

Spécifie la hauteur de l'élément racine au moment du design, indépendamment de la hauteur au moment de l'exécution. Ajouté automatiquement lorsque vous cliquez sur la balise de taille racine (balise de taille racine).

 
<Window x:Class="DesignDataDemo.MainWindow"
        xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:DesignDataDemo"
        Title="MainWindow" mc:Ignorable="d" xmlns:d="https://schemas.microsoft.com/expression/blend/2008" xmlns:mc="https://schemas.openxmlformats.org/markup-compatibility/2006" d:DesignHeight="350" d:DesignWidth="525" SizeToContent="WidthAndHeight">

d:DesignWidth

Spécifie la largeur de l'élément racine au moment du design, indépendamment de la largeur au moment de l'exécution. Ajouté automatiquement lorsque vous cliquez sur la balise de taille racine (balise de taille racine).

 
<Window x:Class="DesignDataDemo.MainWindow"
        xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:local="clr-namespace:DesignDataDemo"
        Title="MainWindow" mc:Ignorable="d" xmlns:d="https://schemas.microsoft.com/expression/blend/2008" xmlns:mc="https://schemas.openxmlformats.org/markup-compatibility/2006" d:DesignHeight="350" d:DesignWidth="525" SizeToContent="WidthAndHeight">

d:DataContext

Spécifie un contexte de données au moment du design pour un contrôle et ses enfants. Un modèle commun consiste à déclarer des liaisons de contrôle dans la vue XAML et à définir le DataContext utilisé pour remplir les liaisons au moment de l'exécution. Si vous utilisez ce modèle, vous pouvez définir d:DataContext afin que le concepteur soit informé de la forme de vos types. Cela vous permet d'utiliser le générateur de liaisons de données pour créer des liaisons en mode Design. Pour plus d'informations, consultez Procédure pas à pas : création d'une liaison de données à l'aide du Concepteur WPF.

 
<Grid d:DataContext="{d:DesignInstance Type=local:Customer}" Name="_grid">

d:DesignInstance

Utilisé dans le cadre d'une déclaration d:DataContext ou d:DesignSource. Spécifie le type que vous pouvez utiliser en tant que source de données pour la création d'une liaison avec des contrôles dans le concepteur. Le type n'a pas besoin de pouvoir être créé en XAML. Pour plus d'informations, consultez Procédure pas à pas : utilisation d'un DesignInstance à lier aux données dans le concepteur.

 
<Grid d:DataContext="{d:DesignInstance Type=local:Customer}" Name="_grid">

d:DesignData

Utilisé dans le cadre d'une déclaration d:DataContext ou d:DesignSource. Spécifie un fichier XAML qui contient les exemples de données à utiliser au moment du design. Utilisez les actions de génération DesignData ou DesignDataWithDesignTimeCreatableTypes pour intégrer vos exemples de données dans votre projet. Des valeurs peuvent être assignées aux propriétés en lecture seule. Pour plus d'informations, consultez Procédure pas à pas : utilisation d'exemples de données dans le Concepteur WPF.

 
<StackPanel d:DataContext="{d:DesignData Source=./DesignData/SampleCustomer.xaml}" Grid.Row="0"></StackPanel>

d:DesignSource

Spécifie une source des données au moment du design pour un CollectionViewSource. Le concepteur est ainsi informé de la forme de vos types. Cela vous permet d'utiliser le générateur de liaisons de données pour créer des liaisons.

 
<CollectionViewSource x:Key="CustomerViewSource" d:DesignSource="{d:DesignInstance local:Customer, CreateList=True}" />

d:IsDesignTimeCreatable

Dans l'extension de balisage d:DesignInstance, spécifie que l'instance de conception est créée à partir de votre type, au lieu d'un type de substitution généré par le concepteur.

 
<Grid d:DataContext="{d:DesignInstance local:Customer, IsDesignTimeCreatable=True}">

d:CreateList

Dans l'extension de balisage d:DesignInstance, spécifie que l'instance de conception est une liste du type spécifié.

 
<CollectionViewSource x:Key="CustomerViewSource" d:DesignSource="{d:DesignInstance local:Customer, CreateList=True}" />

d:Type

Dans l'extension de balisage d:DesignInstance, spécifie le type à créer. Utilisez d:IsDesignTimeCreatable pour spécifier ce qui est créé : une instance, votre type ou un type de substitution généré par le concepteur.

 
<CollectionViewSource x:Key="CustomerViewSource" d:DesignSource="{d:DesignInstance Type=local:Customer, CreateList=True}" />

Accès aux attributs au moment du design

Vous accédez aux attributs au moment du design via l'espace de noms https://schemas.microsoft.com/expression/blend/2008 Cet espace de noms est mappé automatiquement lorsque vous cliquez sur la balise de taille racine (balise de taille racine ) dans l'angle inférieur droit de MainWindow en mode Design.

Actions de génération

Pour activer d:DesignData, vous définissez des actions de génération sur les fichiers XAML qui contiennent vos exemples de données. Le tableau suivant décrit les actions de génération. Pour plus d'informations, consultez Procédure pas à pas : utilisation d'exemples de données dans le Concepteur WPF.

Action de génération

Description

DesignData

Utilisez cette action de build lorsque les exemples de types de données ne peuvent pas être créés ou possèdent des propriétés en lecture seule pour lesquelles vous souhaitez définir des valeurs d'exemples de données. Le concepteur WPF et Silverlight crée des types de remplacement qui ont les mêmes propriétés que vos types d'objet métier. Vos types n'ont pas besoin de pouvoir être créés. Cela élimine la complexité liée au méthodes de fabrique, aux types abstraits et aux connexions de base de données. Des valeurs peuvent être assignées aux propriétés en lecture seule.

DesignDataWithDesignTimeCreatableTypes

Utilisez cette action de build lorsque les exemples de types de données sont des types pouvant être créés à l'aide de leurs constructeurs vides par défaut. Le concepteur WPF et Silverlight crée des instances de vos types définis dans le fichier d'exemples de données. Vos types doivent pouvoir être créés en XAML.

Voir aussi

Tâches

Procédure pas à pas : création d'une liaison de données à l'aide du Concepteur WPF

Procédure pas à pas : utilisation d'un DesignInstance à lier aux données dans le concepteur

Autres ressources

Procédure pas à pas : utilisation d'exemples de données dans le Concepteur WPF