XDocument.LoadAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
| LoadAsync(TextReader, LoadOptions, CancellationToken) |
Vytvoří nový XDocument a inicializuje jeho základní strom XML pomocí zadaného TextReader parametru, volitelně zachová prázdné znaky. |
| LoadAsync(XmlReader, LoadOptions, CancellationToken) |
Vytvoří nový XDocument obsahující obsah zadaného XmlReaderobjektu . |
| LoadAsync(Stream, LoadOptions, CancellationToken) |
Asynchronně vytvoří nový XDocument a inicializuje jeho základní strom XML ze zadaného datového proudu, volitelně zachová prázdné znaky. |
LoadAsync(TextReader, LoadOptions, CancellationToken)
- Zdroj:
- XDocument.cs
- Zdroj:
- XDocument.cs
- Zdroj:
- XDocument.cs
Vytvoří nový XDocument a inicializuje jeho základní strom XML pomocí zadaného TextReader parametru, volitelně zachová prázdné znaky.
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)Parametry
- textReader
- TextReader
Čtečka, která obsahuje nezpracované XML pro čtení do nově vytvořeného XDocumentsouboru .
- options
- LoadOptions
Sada možností načtení.
- cancellationToken
- CancellationToken
Token zrušení.
Návraty
Nový XDocument obsahující obsah zadaného TextReaderobjektu .
Výjimky
Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.
Poznámky
Pokud LoadOptions.PreserveWhitespace je nastavená, vlastnost je nastavená XmlReaderSettings.IgnoreWhitespace na false.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Load(TextReader, LoadOptions).
Platí pro
LoadAsync(XmlReader, LoadOptions, CancellationToken)
- Zdroj:
- XDocument.cs
- Zdroj:
- XDocument.cs
- Zdroj:
- XDocument.cs
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)Parametry
- options
- LoadOptions
Sada možností načtení.
- cancellationToken
- CancellationToken
Token zrušení.
Návraty
Nový XDocument obsahující obsah zadaného XmlReaderobjektu .
Výjimky
Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.
Poznámky
Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Load(XmlReader, LoadOptions).
Platí pro
LoadAsync(Stream, LoadOptions, CancellationToken)
- Zdroj:
- XDocument.cs
- Zdroj:
- XDocument.cs
- Zdroj:
- XDocument.cs
Asynchronně vytvoří nový XDocument a inicializuje jeho základní strom XML ze zadaného datového proudu, volitelně zachová prázdné znaky.
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)Parametry
- stream
- Stream
Datový proud obsahující nezpracovaný XML, který se má načíst do nově vytvořeného XDocumentsouboru .
- options
- LoadOptions
Sada možností načtení.
- cancellationToken
- CancellationToken
Token zrušení.
Návraty
Nový XDocument obsahující obsah zadaného Streamobjektu .
Výjimky
Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.
Poznámky
Pokud LoadOptions.PreserveWhitespace je nastavená, podkladová XmlReaderSettings.IgnoreWhitespace vlastnost je nastavená na falsehodnotu .
Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Load(Stream, LoadOptions).
