XmlWriter.WriteElementStringAsync(String, String, String, String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Asynchroon schrijft een element met het opgegeven voorvoegsel, de lokale naam, de naamruimte-URI en de waarde.
public:
System::Threading::Tasks::Task ^ WriteElementStringAsync(System::String ^ prefix, System::String ^ localName, System::String ^ ns, System::String ^ value);public System.Threading.Tasks.Task WriteElementStringAsync(string prefix, string localName, string ns, string value);public System.Threading.Tasks.Task WriteElementStringAsync(string? prefix, string localName, string? ns, string value);member this.WriteElementStringAsync : string * string * string * string -> System.Threading.Tasks.TaskPublic Function WriteElementStringAsync (prefix As String, localName As String, ns As String, value As String) As TaskParameters
- prefix
- String
Het voorvoegsel van het element.
- localName
- String
De lokale naam van het element.
- ns
- String
De naamruimte-URI van het element.
- value
- String
De waarde van het element.
Retouren
De taak die de asynchrone WriteElementString bewerking vertegenwoordigt.
Uitzonderingen
Er XmlWriter is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.
– of –
Er is een XmlWriter asynchrone methode aangeroepen zonder de Async vlag in te stellen op true. In dit geval InvalidOperationException wordt het bericht 'XmlWriterSettings.Async instellen op true als u Async-methoden wilt gebruiken' weergegeven.
Opmerkingen
Dit is de asynchrone versie van WriteElementString, met dezelfde functionaliteit. Als u deze methode wilt gebruiken, moet u de Async vlag instellen op true.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door WriteElementString(String, String, String, String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
