XDocument.LoadAsync Metodo

Definizione

Spazio dei nomi:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

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

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);

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

static member LoadAsync : System.IO.TextReader * System.Xml.Linq.LoadOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.Linq.XDocument>

Public Shared Function LoadAsync (textReader As TextReader, options As LoadOptions, cancellationToken As CancellationToken) As Task(Of XDocument)

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

Task<XDocument>

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

Eccezioni

OperationCanceledException

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).

LoadAsync(XmlReader, LoadOptions, CancellationToken)

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);

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

static member LoadAsync : System.Xml.XmlReader * System.Xml.Linq.LoadOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.Linq.XDocument>

Public Shared Function LoadAsync (reader As XmlReader, options As LoadOptions, cancellationToken As CancellationToken) As Task(Of XDocument)

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

Task<XDocument>

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

Eccezioni

OperationCanceledException

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).

LoadAsync(Stream, LoadOptions, CancellationToken)

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);

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

static member LoadAsync : System.IO.Stream * System.Xml.Linq.LoadOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Xml.Linq.XDocument>

Public Shared Function LoadAsync (stream As Stream, options As LoadOptions, cancellationToken As CancellationToken) As Task(Of XDocument)

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

Task<XDocument>

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

Eccezioni

OperationCanceledException

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).