Controllo XMLNodes

Aggiornamento: novembre 2007

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto Progetti a livello di documento Versione Microsoft Office Word 2007 Word 2003 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Il controllo XMLNodes è un insieme di oggetti nodo XML mappati che espone eventi. Il controllo XMLNodes viene creato solo quando un elemento ripetuto dello schema viene mappato in un documento di Microsoft Office Word. Se l'elemento ripetuto contiene elementi figlio, questi verranno creati come controlli XMLNodes.

Una volta creato l'insieme di nodi XML in Visual Studio Tools per Office, è possibile eseguire la programmazione per il controllo direttamente, senza dovere passare al modello a oggetti di Word. Il controllo XMLNodes può essere eliminato solo rimuovendo il mapping dell'elemento dal documento.

Nota:
Se si accede a un elemento figlio del controllo XMLNodes mediante la proprietà Item, viene restituito un oggetto Microsoft.Office.Interop.Word.XMLNode invece di un controllo Microsoft.Office.Tools.Word.XMLNode. Per ulteriori informazioni, vedere Limitazioni a livello di codice degli elementi e dei controlli host.

Associazione di dati al controllo

Un controllo XMLNodes non supporta l'associazione dati. Questa condizione si verifica perché il controllo XMLNodes non dispone della funzionalità di associazione dati complessa e l'associazione dati semplice non è in grado di rappresentare i dati ripetuti.

Formattazione

La formattazione che è possibile applicare al testo all'interno del documento può essere applicata a un controllo XMLNodes.

Eventi

Gli eventi disponibili per il controllo XMLNodes sono i seguenti:

• AfterInsert

• BeforeDelete

• ContextEnter

• ContextLeave

• Deselect

• Disposed

• Select

• ValidationError

Confronto di eventi

È possibile acquisire un evento quando l'utente sposta il cursore nel contesto di un particolare controllo XMLNodes. Ad esempio, è possibile disporre di un controllo XMLNodes denominato Customer che dispone di un controllo figlio XMLNodes denominato Company e di un controllo Company che dispone di due controlli figlio XMLNodes denominati CompanyName e CompanyRegion come illustrato di seguito.

<Customer>
    <Company>
        <CompanyName>
        <CompanyRegion>

Se si desidera visualizzare un controllo nel riquadro delle azioni ogni volta che il cursore viene spostato nel nodo Company, la posizione del cursore in CompanyName o in CompanyRegion non è determinante, poiché questi due controlli sono entrambi nel contesto di Company. In questo caso, il codice può essere creato nell'evento ContextEnter di Company.

Nella maggior parte dei casi, quando il cursore è spostato su un controllo XMLNodes, vengono generati gli eventi Select e ContextEnter. Nella tabella che segue sono illustrate le differenze tra questi eventi.

Evento Select	Evento ContextEnter
Viene generato quando il cursore viene posizionato all'interno di uno dei nodi dell'insieme XMLNodes.	Viene generato quando il cursore viene posizionato in uno dei nodi o dei nodi di derivazione dell'insieme XMLNodes, da un'area esterna del contesto del nodo. In altre parole, l'evento viene generato solo quando il contesto cambia e può essere generato per più controlli XMLNodes nidificati.

Ad esempio, quando si sposta il cursore da Customer a CompanyName, vengono generati gli eventi ContextEnter per Customer, Company e CompanyName. Se poi si sposta il cursore da CompanyName a CompanyRegion, viene generato solo l'evento ContextEnter per CompanyRegion, in quanto il contesto di Company e Customer è uguale. Nel documento possono essere presenti più nodi Company. Se si sposta il cursore dal nodo CompanyName di un nodo Company al nodo CompanyName di un altro nodo Company, il contesto è lo stesso, per cui viene generato solo l'evento Select.

Le stesse differenze distinguono l'evento ContextLeave dall'evento Deselect.

Vedere anche

Attività

Procedura: aggiungere controlli XMLNode ai documenti di Word

Procedura: mappare schemi a documenti di Word in Visual Studio

Concetti

Cenni preliminari sugli elementi e sui controlli host

Controllo XMLNode

Limitazioni a livello di codice degli elementi e dei controlli host

Altre risorse

Controlli host di Word

Controlli host di Excel