Attributi della fase di progettazione

  • Articolo

Quando si compilano applicazioni WPF o Silverlight tramite WPF Designer per Visual Studio, talvolta è necessario fornire informazioni per un comportamento corretto della visualizzazione Progettazione. Per specificare questo tipo di informazioni è possibile utilizzare gli attributi della fase di progettazione. Tali attributi consentono, ad esempio, di ridimensionare la finestra radice con valori specifici adattati alla progettazione del layout, pur mantenendo in fase di esecuzione il ridimensionamento determinato dal contenuto. Gli attributi della fase di progettazione vengono ignorati durante la compilazione e non hanno alcun effetto in fase di esecuzione.

Attributi della fase di progettazione

WPF Designer fornisce i seguenti attributi della fase di progettazione.

Attributo della fase di progettazione

Descrizione

Esempio di utilizzo

d:DesignHeight

Specifica in fase di progettazione l'altezza dell'elemento radice, indipendentemente dell'altezza in fase di esecuzione. Aggiunto automaticamente facendo clic sul tag di ridimensionamento radice (tag dimensioni radice).

 
<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

Specifica in fase di progettazione la larghezza dell'elemento radice, indipendentemente della larghezza in fase di esecuzione. Aggiunto automaticamente facendo clic sul tag di ridimensionamento radice (tag dimensioni radice).

 
<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

Specifica un contesto dati della fase di progettazione per un controllo e i relativi figli. Un modello comune consiste nel dichiarare associazioni del controllo in visualizzazione XAML e impostare DataContext utilizzato per popolare le associazioni in fase di esecuzione. Se si utilizza questo modello, è possibile impostare d:DataContext in modo che la finestra di progettazione sia in grado di rilevare la forma dei tipi. Questo consente di utilizzare il generatore di associazioni dati per creare associazioni in visualizzazione Progettazione. Per ulteriori informazioni, vedere Procedura dettagliata: creazione di un'associazione dati tramite WPF Designer.

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

d:DesignInstance

Utilizzato come parte di una dichiarazione d:DataContext o d:DesignSource. Specifica il tipo che è possibile utilizzare come un'origine dati per l'associazione ai controlli nella finestra di progettazione. Non è necessario che il tipo sia creabile in XAML. Per ulteriori informazioni, vedere Procedura dettagliata: utilizzo di DesignInstance per creare un'associazione a dati nella finestra di progettazione.

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

d:DesignData

Utilizzato come parte di una dichiarazione d:DataContext o d:DesignSource. Specifica un file XAML che contiene dati di esempio per l'utilizzo in fase di progettazione. Utilizzare le operazioni di compilazione di DesignData o DesignDataWithDesignTimeCreatableTypes per integrare i dati di esempio con il progetto. È possibile assegnare valori alle proprietà di sola lettura. Per ulteriori informazioni, vedere Procedura dettagliata: utilizzo di dati di esempio in WPF Designer.

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

d:DesignSource

Specifica un'origine dati della fase di progettazione per CollectionViewSource. Rende la finestra di progettazione in grado di rilevare la forma dei tipi. Questo consente di utilizzare il generatore di associazioni dati per creare associazioni.

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

d:IsDesignTimeCreatable

Nell'estensione di markup d:DesignInstance, specifica che l'istanza di progettazione viene creata dal tipo specificato, anziché da un tipo sostitutivo generato dalla finestra di progettazione.

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

d:CreateList

Nell'estensione di markup d:DesignInstance, specifica che l'istanza di progettazione è un elenco del tipo specificato.

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

d:Type

Nell'estensione di markup d:DesignInstance, specifica il tipo da creare. Utilizzare d:IsDesignTimeCreatable per specificare se viene creata un'istanza, il tipo specificato o un tipo sostitutivo generato dalla finestra di progettazione.

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

Accesso agli attributi della fase di progettazione

Si accede agli attributi della fase di progettazione tramite lo spazio dei nomi https://schemas.microsoft.com/expression/blend/2008. Lo spazio dei nomi viene associato automaticamente facendo clic sul tag di ridimensionamento della radice (tag dimensioni radice) nella parte inferiore destra di MainWindow in visualizzazione Progettazione.

Operazioni di compilazione

Per abilitare d:DesignData, si impostano operazioni di compilazione sui file XAML che contengono i dati di esempio. Nella tabella riportata di seguito vengono descritte le operazioni di compilazione. Per ulteriori informazioni, vedere Procedura dettagliata: utilizzo di dati di esempio in WPF Designer.

Operazione di compilazione

Descrizione

DesignData

Utilizzare questa azione di compilazione quando i tipi di dati di esempio non possono essere creati o dispongono di proprietà di sola lettura per cui si desidera definire valori di dati di esempio. WPF e Silverlight Designer creano tipi sostitutivi che dispongono delle stesse proprietà dei tipi di oggetto business. Non è necessario che i tipi siano creabili. Questo elimina la complessità relativa a metodi factory, tipi astratti e connessioni di database. È possibile assegnare valori alle proprietà di sola lettura.

DesignDataWithDesignTimeCreatableTypes

Utilizzare questa azione di compilazione quando i tipi di dati di esempio possono essere creati tramite i costruttori vuoti predefiniti. WPF e Silverlight Designer creano istanze dei tipi definiti nel file di dati di esempio. È necessario che i tipi siano creabili in XAML.

Vedere anche

Attività

Procedura dettagliata: creazione di un'associazione dati tramite WPF Designer

Procedura dettagliata: utilizzo di DesignInstance per creare un'associazione a dati nella finestra di progettazione

Altre risorse

Procedura dettagliata: utilizzo di dati di esempio in WPF Designer