XDocument.LoadAsync Metodo

Definizione

Overload

LoadAsync(TextReader, LoadOptions, CancellationToken)

Crea un nuovo oggetto XDocument e ne inizializza la struttura ad albero XML sottostante usando il parametro TextReader specificato, mantenendo facoltativamente lo spazio vuoto.

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Crea un nuovo oggetto XDocument che include il contenuto dell'oggetto XmlReader specificato.

LoadAsync(Stream, LoadOptions, CancellationToken)

Crea un nuovo XDocument in modo asincrono e ne inizializza la struttura ad albero XML sottostante dal flusso specificato, mantenendo facoltativamente lo spazio vuoto.

LoadAsync(TextReader, LoadOptions, CancellationToken)

Origine:
XDocument.cs
Origine:
XDocument.cs
Origine:
XDocument.cs

Crea un nuovo oggetto XDocument e ne inizializza la struttura ad albero XML sottostante usando il parametro TextReader specificato, mantenendo facoltativamente lo spazio vuoto.

public static System.Threading.Tasks.Task<System.Xml.Linq.XDocument> LoadAsync (System.IO.TextReader textReader, System.Xml.Linq.LoadOptions options, System.Threading.CancellationToken cancellationToken);

Parametri

textReader
TextReader

Lettore contenente il codice XML non elaborato da leggere nell'oggetto XDocument appena creato.

options
LoadOptions

Set di opzioni di caricamento.

cancellationToken
CancellationToken

Token di annullamento.

Restituisce

Nuovo XDocument che include il contenuto dell'oggetto TextReader specificato.

Eccezioni

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Se LoadOptions.PreserveWhitespace è impostato, la XmlReaderSettings.IgnoreWhitespace proprietà è impostata su false.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Load(TextReader, LoadOptions).

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Origine:
XDocument.cs
Origine:
XDocument.cs
Origine:
XDocument.cs

Crea un nuovo oggetto XDocument che include il contenuto dell'oggetto XmlReader specificato.

public static System.Threading.Tasks.Task<System.Xml.Linq.XDocument> LoadAsync (System.Xml.XmlReader reader, System.Xml.Linq.LoadOptions options, System.Threading.CancellationToken cancellationToken);

Parametri

reader
XmlReader

Lettore contenente il codice XML da leggere nel nuovo oggetto XDocument.

options
LoadOptions

Set di opzioni di caricamento.

cancellationToken
CancellationToken

Token di annullamento.

Restituisce

Nuovo XDocument che include il contenuto dell'oggetto XmlReader specificato.

Eccezioni

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Load(XmlReader, LoadOptions).

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

LoadAsync(Stream, LoadOptions, CancellationToken)

Origine:
XDocument.cs
Origine:
XDocument.cs
Origine:
XDocument.cs

Crea un nuovo XDocument in modo asincrono e ne inizializza la struttura ad albero XML sottostante dal flusso specificato, mantenendo facoltativamente lo spazio vuoto.

public static System.Threading.Tasks.Task<System.Xml.Linq.XDocument> LoadAsync (System.IO.Stream stream, System.Xml.Linq.LoadOptions options, System.Threading.CancellationToken cancellationToken);

Parametri

stream
Stream

Flusso contenente il codice XML non elaborato da leggere nell'oggetto XDocument appena creato.

options
LoadOptions

Set di opzioni di caricamento.

cancellationToken
CancellationToken

Token di annullamento.

Restituisce

Nuovo XDocument che include il contenuto dell'oggetto Stream specificato.

Eccezioni

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Se LoadOptions.PreserveWhitespace è impostato, la proprietà sottostante XmlReaderSettings.IgnoreWhitespace viene impostata su false.

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Load(Stream, LoadOptions).

Si applica a

.NET 9 e altre versioni
Prodotto Versioni
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1