XmlWriter.WriteNmTokenAsync(String) Methode

Definitie

Schrijft asynchroon de opgegeven naam uit, zodat deze een geldig NmToken is volgens de W3C XML 1.0-aanbeveling (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name).

public:
 virtual System::Threading::Tasks::Task ^ WriteNmTokenAsync(System::String ^ name);
public virtual System.Threading.Tasks.Task WriteNmTokenAsync(string name);
abstract member WriteNmTokenAsync : string -> System.Threading.Tasks.Task
override this.WriteNmTokenAsync : string -> System.Threading.Tasks.Task
Public Overridable Function WriteNmTokenAsync (name As String) As Task

Parameters

name
String

De naam die moet worden geschreven.

Retouren

De taak die de asynchrone WriteNmToken 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 WriteNmToken, 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 WriteNmToken(String)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.

Van toepassing op

Zie ook