XmlWriter.WriteSurrogateCharEntityAsync(Char, Char) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Genererar och skriver asynkront surrogatteckenentiteten för surrogatteckenparet.
public:
virtual System::Threading::Tasks::Task ^ WriteSurrogateCharEntityAsync(char lowChar, char highChar);public virtual System.Threading.Tasks.Task WriteSurrogateCharEntityAsync(char lowChar, char highChar);abstract member WriteSurrogateCharEntityAsync : char * char -> System.Threading.Tasks.Task
override this.WriteSurrogateCharEntityAsync : char * char -> System.Threading.Tasks.TaskPublic Overridable Function WriteSurrogateCharEntityAsync (lowChar As Char, highChar As Char) As TaskParametrar
- lowChar
- Char
Den låga surrogatmamman. Detta måste vara ett värde mellan 0xDC00 och 0xDFFF.
- highChar
- Char
Den höga surrogaten. Detta måste vara ett värde mellan 0xD800 och 0xDBFF.
Returer
Uppgiften som representerar den asynkrona WriteSurrogateCharEntity åtgärden.
Undantag
En XmlWriter metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".
-eller-
En XmlWriter asynkron metod anropades utan att flaggan sattes Async till true. I det här fallet InvalidOperationException genereras meddelandet "Ange XmlWriterSettings.Async till sant om du vill använda Async-metoder".
Kommentarer
Det här är den asynkrona versionen av WriteSurrogateCharEntity, med samma funktioner. Om du vill använda den här metoden måste du ange Async flaggan till true.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av WriteSurrogateCharEntity(Char, Char).