Supporto dell'associazione all'elemento include

In .NET Framework è incluso un supporto parziale per l'associazione all'elemento <include>.

Durante la generazione di codice sorgente dall'elemento <include>, Xsd.exe individua un documento XSD incluso come percorso assoluto di file system specificato mediante l'attributo schemaLocation.

Descrizione

L'elemento <include> è simile all'elemento <import>. Entrambi gli elementi vengono visualizzati come figli dell'elemento <schema> principale e devono trovarsi prima degli altri figli. Entrambi vengono inoltre inseriti in una definizione <schema> separata, generalmente definita in un altro file xsd. Vi è un'unica distinzione principale, come illustrato di seguito:

• <import>: importa le dichiarazioni e le definizioni dello schema all'interno di uno spazio dei nomi separato specificato mediante l'attributo namespace.

• <include>: include ulteriori definizioni e dichiarazioni dello schema all'interno dello stesso spazio dei nomi specificato come targetNamespace per la definizione dello schema XML esistente.

Una definizione dello schema XML che utilizza gli elementi <include> è sintatticamente equivalente a una definizione dello schema XML le cui definizioni in esso contenute vengono visualizzate direttamente.

Durante la generazione dei documenti dello schema XML da un insieme di classi in un assembly, Xsd.exe crea un solo file xsd per lo spazio dei nomi di destinazione. In altri termini non esistono due file xsd generati che abbiano lo stesso valore per l'attributo targetNamespace dell'elemento <schema> principale. Pertanto, l'elemento <include> non viene mai generato. Uno sviluppatore può sempre suddividere un file xsd generato in più file mediante l'elemento <include>.

Durante la generazione di codice sorgente da un documento dello schema XML, Xsd.exe riconosce l'elemento <include>. I documenti inclusi da XSD non devono essere passati come argomenti aggiuntivi a Xsd.exe. Vengono invece individuati mediante l'attributo schemaLocation. Il valore dell'attributo deve essere un percorso di file system assoluto.

Nell'esempio riportato di seguito viene illustrato un valore schemaLocation valido:

<xsd:include schemaLocation="c:\\projectRoot\\source\\xsd\\included1.xsd" />

Nota:
Xsd.exe ignora l'attributo schemaLocation quando viene visualizzato nell'elemento <import> . Per Xsd.exe i file importati vengono invece specificati come argomenti aggiuntivi da riga di comando. Vedere Supporto dell'associazione all'elemento import.

Attributi possibili	Supporto per l'associazione
id	L'utilità Xsd.exe ignora l'attributo id che fornisce un identificatore univoco.
schemaLocation	Vedere il testo precedente.

Elementi padre possibili: <schema>

Elementi figlio possibili: <annotation>

Vedere anche

Riferimenti

XmlSchemaInclude

Copyright © 2007 Microsoft Corporation. Tutti i diritti riservati.