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

Articolo
05/27/2012

[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]

In questa procedura dettagliata viene illustrato come utilizzare WPF Designer per Visual Studio per creare associazioni dati in fase di progettazione per un contesto dati assegnato in fase di esecuzione. Per creare l'associazione dati, è possibile utilizzare il generatore di associazioni dati per creare uno speciale contesto dati della fase di progettazione e impostare DesignInstance su un tipo di oggetto business. DesignInstance è una proprietà della fase di progettazione.

Questa procedura dettagliata prevede l'esecuzione delle attività seguenti:

Creazione del progetto.
Creazione di un oggetto business della classe Customer.
Creazione di un'associazione dati di un controllo TextBox a un'istanza della fase di progettazione della classe Customer in un contesto dati.

Al termine, si disporrà di una casella di testo che viene associata in fase di esecuzione a un oggetto business. L'associazione dati è impostata in WPF Designer.

Nota

È possibile che le finestre di dialogo e i comandi di menu visualizzati siano diversi da quelli descritti nella Guida a seconda delle impostazioni attive o dell'edizione del programma.Per modificare le impostazioni, scegliere Importa/esporta impostazioni dal menu Strumenti.Per ulteriori informazioni, vedere Impostazioni di Visual Studio.

Prerequisiti

Per completare la procedura dettagliata, è necessario disporre dei componenti seguenti:

Visual Studio 2010.

Creazione del progetto

Il primo passaggio consiste nella creazione di un progetto di applicazione WPF e nell'abilitazione delle proprietà della fase di progettazione.

Per creare il progetto

Creare un nuovo progetto di applicazione WPF in Visual Basic o Visual C# denominato DataBindingDemo. Per ulteriori informazioni, vedere Procedura: creare un nuovo progetto di applicazione WPF.

MainWindow.xaml viene aperto in WPF Designer.
In visualizzazione Progettazione fare clic sul tag del ridimensionamento della radice () nella parte inferiore destra di MainWindow per impostare il ridimensionamento della radice come automatico.

In visualizzazione XAML la finestra di progettazione aggiunge il mapping dello spazio dei nomi d che consente di accedere ad attributi della fase di progettazione quali DesignHeight e DesignInstance.

Creazione dell'oggetto business

Il passaggio successivo consiste nella creazione dell'oggetto business. L'oggetto business è una classe Customer semplice che dispone di proprietà FirstName e LastName.

Nota

Non è necessario che il tipo di oggetto business sia creabile per l'utilizzo in associazioni dati della fase di progettazione.Ad esempio, è possibile effettuare un'associare a una classe astratta in fase di progettazione.

Per creare l'oggetto business

Aggiungere al progetto una nuova classe denominata Customer. Per ulteriori informazioni, vedere How to: Add New Project Items.

Sostituire il codice generato automaticamente con il codice seguente.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace DataBindingDemo
{
    public class Customer
    {   
        public string FirstName { get; set; }
        public string LastName { get; set; }
    }
}

Impostazione del contesto dati della fase di progettazione

Per creare associazioni dati mediante il generatore di associazioni dati, si crea uno speciale contesto dati della fase di progettazione e si imposta DesignInstance sul tipo di oggetto business.

Per impostare il contesto dati della fase di progettazione

Aprire MainWindow.xaml in WPF Designer.
In visualizzazione XAML aggiungere al tag di apertura di MainWindow il mapping dello spazio dei nomi seguente. Per ulteriori informazioni, vedere Procedura: importare uno spazio dei nomi in XAML.
```
xmlns:local="clr-namespace:DataBindingDemo"
```
Sostituire il tag di apertura dell'elemento Grid con i dati XAML seguenti.
```
<Grid d:DataContext="{d:DesignInstance Type=local:Customer}" Name="_grid">
```
Questo codice XAML stabilisce un contesto dati della fase di progettazione e rende disponibile la classe Customer per la creazione delle associazioni dati.
Compilare la soluzione.

Creazione dell'associazione dati

A questo punto è possibile creare associazioni dati all'oggetto business Customer mediante il generatore di associazioni dati. La procedura riportata di seguito illustra come associare un controllo TextBox alla proprietà FirstName di un oggetto Customer.

Per creare l'associazione dati

Trascinare un controllo TextBox dalla casella degli strumenti su Window.
Nella finestra Proprietà scorrere fino alla proprietà Text.
Sul bordo della colonna sinistra fare clic sul marcatore della proprietà ().

Verrà visualizzato un menu.

Suggerimento

Per visualizzare il menu, è inoltre possibile fare clic con il pulsante destro del mouse sulla riga.
Fare clic su Applica associazione dati.

Verrà visualizzato il generatore di associazioni dati con il riquadro Percorso aperto.
Fare clic su FirstName e premere Invio.

In visualizzazione XAML la proprietà Text dispone di un'associazione dati alla proprietà FirstName del tipo Customer.

Impostazione del contesto dati della fase di esecuzione

Si assegna infine il contesto dati di runtime. L'associazione dati creata in fase di progettazione funziona in fase di esecuzione senza alcuna modifica in XAML o codice.

Per impostare il contesto dati della fase di esecuzione

Nell'editor di codice aprire MainWindow.xaml.cs o MainWindow.xaml.vb.

Sostituire il costruttore MainWindow generato automaticamente con il seguente codice.

public MainWindow()
{
    InitializeComponent();

    Customer c = new Customer();
    c.FirstName = "Brenda";
    c.LastName = "Diaz";

    this._grid.DataContext = c;
}

‎Premere F5 per eseguire l'applicazione.

La casella di testo visualizza il nome dell'oggetto Customer creato in fase di esecuzione.

Passaggi successivi

È possibile creare un'associazione a dati di esempio della fase di progettazione, questa operazione facilita la costruzione del comportamento del layout corretto in fase di esecuzione quando sono disponibili i dati effettivi. Per ulteriori informazioni, vedere Procedura dettagliata: utilizzo di dati di esempio in WPF Designer.

Vedere anche

Condividi tramite