Procedura: Utilizzare le visualizzazioni

Quando si utilizza un modello di modulo di InfoPath, è possibile scrivere codice per accedere alle visualizzazioni del modulo e quindi eseguire un'ampia gamma di azioni sui dati contenuti in tali visualizzazioni. Il modello a oggetti di InfoPath incluso nello spazio dei nomi Microsoft.Office.InfoPath supporta l'accesso alle visualizzazioni di un modulo tramite l'utilizzo dei membri della classe View.

Informazioni generali sulla classe View

La classe View include i metodi e le proprietà seguenti, che possono essere utilizzati dagli sviluppatori di moduli per interagire con una visualizzazione di InfoPath.

Nota:
I metodi e le proprietà della classe View non sono disponibili durante l'evento Loading.

Nome	Descrizione
Metodo DisableAutoUpdate	Disattiva la sincronizzazione automatica tra il documento XML sottostante di un modulo e la visualizzazione associata.
Metodo EnableAutoUpdate	Attiva la sincronizzazione automatica tra il documento XML sottostante di un modulo e la visualizzazione associata.
Metodo ExecuteAction	Esegue un comando di modifica nel documento XML sottostante di un modulo, in base ai dati attualmente selezionati nella visualizzazione.
Metodo ExecuteAction	Esegue un comando di modifica nel documento XML sottostante di un modulo, in base al campo o al gruppo specificato.
Metodo Export	Esporta la visualizzazione in un file nel formato specificato.
Metodo ForceUpdate	Forza la sincronizzazione tra il documento XML sottostante di un modulo e la visualizzazione associata.
Metodo GetContextNodes	Ottiene un riferimento a un oggetto XPathNodeIterator per l'iterazione nei nodi XML restituiti, iniziando dal nodo specificato.
Metodo GetContextNodes	Ottiene un riferimento a un oggetto XPathNodeIterator per l'iterazione nei nodi XML restituiti nella selezione corrente all'interno del controllo associato al campo o al gruppo specificato.
Metodo GetSelectedNodes	Ottiene un riferimento a un oggetto XPathNodeIterator per l'iterazione in tutti i nodi XML inclusi nella selezione corrente di elementi in una visualizzazione.
Metodo SelectNodes	Seleziona un intervallo di nodi in una visualizzazione in base al nodo XML iniziale specificato.
Metodo SelectNodes	Seleziona un intervallo di nodi in una visualizzazione in base al nodo XML iniziale e finale specificato.
Metodo SelectNodes	Seleziona un intervallo di nodi in una visualizzazione in base al nodo XML iniziale, al nodo XML finale e al controllo specificato.
Metodo SelectText	Seleziona il testo contenuto in un controllo modificabile associato al nodo specificato dall'oggetto XPathNavigator passato a questo metodo.
Metodo SelectText	Seleziona il testo contenuto in un controllo modificabile associato al nodo specificato dall'oggetto XPathNavigator passato a questo metodo, nonché il controllo specificato.
Metodo ShowMailItem	Crea un messaggio di posta elettronica contenente la visualizzazione corrente.
Proprietà ViewInfo	Ottiene un riferimento a un oggetto ViewInfo associato alla visualizzazione.
Proprietà Window	Ottiene un riferimento a un oggetto Window associato alla visualizzazione.

Nota:
Il modello a oggetti di InfoPath include inoltre le classi ViewInfoCollection e ViewInfo, che possono essere utilizzate per ottenere informazioni su tutte le visualizzazioni implementate in un modulo.

Utilizzo della classe View

La classe View è accessibile tramite la proprietà CurrentView della classe XmlForm, a cui si accede utilizzando la parola chiave this in C# o Me in Visual Basic. Nell'esempio seguente viene illustrata la visualizzazione di una finestra di messaggio con il nome della visualizzazione corrente attiva.

MessageBox.Show("Current view name: " + 
   this.CurrentView.Name);

MessageBox.Show("Current view name: " & _
   Me.CurrentView.Name)

Tutti i modelli di modulo di InfoPath contengono almeno una visualizzazione predefinita. In InfoPath, tuttavia, viene inoltre supportata la creazione di più visualizzazioni del documento XML sottostante di un modulo. Se si dispone di più visualizzazioni, è possibile utilizzare ViewInfoCollection per tutte le visualizzazioni implementate nel modello di modulo. Per accedere all'elemento ViewInfoCollection di un modello di modulo, utilizzare la proprietà ViewInfos della classe XmlForm. È possibile modificare a livello di programmazione la visualizzazione corrente attiva tramite il metodo SwitchView di ViewInfoCollection, come illustrato nell'esempio seguente.

this.ViewInfos.SwitchView("MySecondView");

Me.ViewInfos.SwitchView("MySecondView")

Nell'esempio precedente il passaggio a un'altra visualizzazione verrà eseguito solo dopo l'apertura del modulo. Per impostare una visualizzazione predefinita durante l'evento OnLoad, utilizzare la proprietà Initial della classe ViewInfoCollection come illustrato nell'esempio seguente. Si noti tuttavia che questo valore avrà effetto solo dopo il salvataggio e la riapertura del modulo.

this.ViewInfos.Initial = this.ViewInfos["MyInitialView"];

Me.ViewInfos.Initial = Me.ViewInfos["MyInitialView"];