XElement.LoadAsync Metodo

Definizione

Spazio dei nomi:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Overload

LoadAsync(Stream, LoadOptions, CancellationToken)	Crea un nuovo XElement in modo asincrono e ne inizializza la struttura ad albero XML sottostante usando il flusso specificato, mantenendo facoltativamente lo spazio vuoto.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Crea un nuovo XElement in modo asincrono e ne inizializza la struttura ad albero XML sottostante usando il lettore di testo specificato, mantenendo facoltativamente lo spazio vuoto.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Crea un nuovo XElement in modo asincrono e ne inizializza la struttura ad albero XML sottostante usando il lettore XML specificato, mantenendo facoltativamente lo spazio vuoto.

LoadAsync(Stream, LoadOptions, CancellationToken)

Origine:

XElement.cs

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

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

public static System.Threading.Tasks.Task<System.Xml.Linq.XElement> 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.XElement>

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

Parametri

stream

Stream

Flusso contenente codice XML non elaborato da leggere.

options

LoadOptions

Combinazione bit per bit dei valori di enumerazione che specificano le opzioni di caricamento per analizzare il codice XML.

cancellationToken

CancellationToken

Token che può essere utilizzato per richiedere l'annullamento dell'operazione asincrona.

Restituisce

Task<XElement>

Nuovo oggetto XElement che include il contenuto del flusso specificato.

Eccezioni

OperationCanceledException

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

Commenti

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

Questo metodo archivia nell'attività che 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).

LoadAsync(TextReader, LoadOptions, CancellationToken)

Origine:

XElement.cs

Crea un nuovo XElement in modo asincrono e ne inizializza la struttura ad albero XML sottostante usando il lettore di testo specificato, mantenendo facoltativamente lo spazio vuoto.

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

public static System.Threading.Tasks.Task<System.Xml.Linq.XElement> 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.XElement>

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

Parametri

textReader

TextReader

Lettore contenente codice XML non elaborato da leggere.

options

LoadOptions

Combinazione bit per bit dei valori di enumerazione che specificano le opzioni di caricamento per analizzare il codice XML.

cancellationToken

CancellationToken

Token che può essere utilizzato per richiedere l'annullamento dell'operazione asincrona.

Restituisce

Task<XElement>

Nuovo oggetto XElement che include il contenuto del lettore specificato.

Eccezioni

OperationCanceledException

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

Commenti

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

Questo metodo archivia nell'attività che 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:

XElement.cs

Crea un nuovo XElement in modo asincrono e ne inizializza la struttura ad albero XML sottostante usando il lettore XML specificato, mantenendo facoltativamente lo spazio vuoto.

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

public static System.Threading.Tasks.Task<System.Xml.Linq.XElement> 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.XElement>

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

Parametri

reader

XmlReader

Lettore contenente il codice XML da leggere.

options

LoadOptions

Combinazione bit per bit dei valori di enumerazione che specificano le opzioni di caricamento per analizzare il codice XML.

cancellationToken

CancellationToken

Token che può essere utilizzato per richiedere l'annullamento dell'operazione asincrona.

Restituisce

Task<XElement>

Nuovo oggetto XElement che include il contenuto del lettore specificato.

Eccezioni

OperationCanceledException

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

Commenti

Questo metodo archivia nell'attività che 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).