XmlDataDocument.Load Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Carica l'oggetto XmlDataDocument utilizzando l'origine dati specificata e sincronizza con DataSet i dati caricati.
Overload
| Nome | Descrizione |
|---|---|
| Load(Stream) |
Carica l'oggetto |
| Load(TextReader) |
Carica l'oggetto |
| Load(String) |
Carica l'oggetto |
| Load(XmlReader) |
Carica l'oggetto |
Commenti
Annotazioni
Per visualizzare i dati XML in modo relazionale, è prima necessario specificare uno schema da utilizzare per il mapping dei dati. Questa operazione può essere eseguita chiamando il ReadXmlSchema metodo o creando le tabelle e le colonne all'interno di DataSet manualmente. Questo passaggio deve essere eseguito prima di chiamare Load.
XmlDataDocument non supporta la creazione di riferimenti all'entità. Se i dati includono riferimenti all'entità, il Load metodo risolve ed espande i riferimenti a qualsiasi entità. Tuttavia, se si usa l'overload Load che accetta come XmlReader argomento , è necessario specificare un XmlReader oggetto in grado di risolvere le entità.
Load(Stream)
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
Carica l'oggetto XmlDataDocument dal flusso specificato.
public:
override void Load(System::IO::Stream ^ inStream);public override void Load(System.IO.Stream inStream);override this.Load : System.IO.Stream -> unitPublic Overrides Sub Load (inStream As Stream)Parametri
- inStream
- Stream
Flusso contenente il documento XML da caricare.
Commenti
XmlDataDocument non supporta la creazione di riferimenti all'entità. Se i dati includono riferimenti all'entità, il Load metodo risolve ed espande i riferimenti a qualsiasi entità.
Annotazioni
Per visualizzare i dati XML in modo relazionale, è prima necessario specificare uno schema da utilizzare per il mapping dei dati. Questa operazione può essere eseguita chiamando il ReadXmlSchema metodo o creando le tabelle e le colonne all'interno di DataSet manualmente. Questo passaggio deve essere eseguito prima di chiamare Load.
Si applica a
Load(TextReader)
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
Carica l'oggetto XmlDataDocument dall'oggetto specificato TextReader.
public:
override void Load(System::IO::TextReader ^ txtReader);public override void Load(System.IO.TextReader txtReader);override this.Load : System.IO.TextReader -> unitPublic Overrides Sub Load (txtReader As TextReader)Parametri
- txtReader
- TextReader
Oggetto TextReader utilizzato per inserire i dati XML nel documento.
Commenti
XmlDataDocument non supporta la creazione di riferimenti all'entità. Se i dati includono riferimenti all'entità, il Load metodo risolve ed espande i riferimenti a qualsiasi entità.
Annotazioni
Per visualizzare i dati XML in modo relazionale, è prima necessario specificare uno schema da utilizzare per il mapping dei dati. Questa operazione può essere eseguita chiamando il ReadXmlSchema metodo o creando le tabelle e le colonne all'interno di DataSet manualmente. Questo passaggio deve essere eseguito prima di chiamare Load.
Si applica a
Load(String)
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
Carica l'oggetto XmlDataDocument utilizzando l'URL specificato.
public:
override void Load(System::String ^ filename);public override void Load(string filename);override this.Load : string -> unitPublic Overrides Sub Load (filename As String)Parametri
- filename
- String
URL del file contenente il documento XML da caricare.
Commenti
XmlDataDocument non supporta la creazione di riferimenti all'entità. Se i dati includono riferimenti all'entità, il Load metodo risolve ed espande i riferimenti a qualsiasi entità.
Annotazioni
Per visualizzare i dati XML in modo relazionale, è prima necessario specificare uno schema da utilizzare per il mapping dei dati. Questa operazione può essere eseguita chiamando il ReadXmlSchema metodo o creando le tabelle e le colonne all'interno di DataSet manualmente. Questo passaggio deve essere eseguito prima di chiamare Load.
Si applica a
Load(XmlReader)
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
- Origine:
- XmlDataDocument.cs
Carica l'oggetto XmlDataDocument dall'oggetto specificato XmlReader.
public:
override void Load(System::Xml::XmlReader ^ reader);public override void Load(System.Xml.XmlReader reader);override this.Load : System.Xml.XmlReader -> unitPublic Overrides Sub Load (reader As XmlReader)Parametri
- reader
- XmlReader
Oggetto XmlReader contenente il documento XML da caricare.
Eccezioni
Il codice XML caricato contiene riferimenti all'entità e il lettore non è in grado di risolvere le entità.
Commenti
XmlDataDocument non supporta la creazione di riferimenti all'entità. Se l'origine dati contiene riferimenti all'entità, è necessario creare un oggetto XmlValidatingReader con la EntityHandling proprietà impostata su EntityHandling.ExpandEntities (comportamento predefinito) e passare XmlValidatingReader al Load metodo . Se non si usa un oggetto XmlValidatingReader, il Load metodo genera un'eccezione.
Il Load metodo mantiene sempre spazi vuoti significativi. La PreserveWhitespace proprietà determina se lo spazio vuoto viene mantenuto o meno. Il valore predefinito è false, lo spazio vuoto non viene mantenuto.
Se il lettore si trova nello stato iniziale(ovvero ReadState=ReadState.Initial), Load utilizza l'intero contenuto del lettore e compila il DOM da ciò che trova.
Se il lettore è già posizionato in un nodo alla profondità "n", questo metodo carica il nodo e tutti i successivi elementi di pari livello fino al tag finale che chiude la profondità "n". I risultati sono i seguenti.
Se il nodo corrente e i relativi elementi di pari livello sono simili ai seguenti:
<!--comment--><element1>one</element1><element2>two</element2>
Load genera un'eccezione, perché un documento non può avere due elementi a livello radice. Se il nodo corrente e i relativi elementi di pari livello sono simili ai seguenti:
<!--comment--><?process
instruction?><!--comment--></endtag>
Load avrà esito positivo; Tuttavia, si avrà un albero DOM incompleto, perché non è presente alcun elemento a livello radice. È necessario aggiungere un elemento a livello radice prima di salvare il documento; in caso contrario, il Save metodo genera un'eccezione.
Se il lettore è posizionato su un nodo foglia non valido per il livello radice di un documento (ad esempio, uno spazio vuoto o un nodo attributo), il lettore continua a leggere finché non viene posizionato su un nodo che può essere usato per la radice. Il documento inizia il caricamento a questo punto.
