XmlWriter.WriteSurrogateCharEntityAsync(Char, Char) Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlWriterAsync.cs

Asynchronně generuje a zapisuje náhradní znak entitu pro dvojici náhradních znaků.

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.Task

Public Overridable Function WriteSurrogateCharEntityAsync (lowChar As Char, highChar As Char) As Task

Parametry

lowChar

Char

Nízká náhrada. Musí to být hodnota mezi 0xDC00 a 0xDFFF.

highChar

Char

Vysoký náhradník. Musí to být hodnota mezi 0xD800 a 0xDBFF.

Návraty

Task

Úloha, která představuje asynchronní WriteSurrogateCharEntity operaci.

Výjimky

InvalidOperationException

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

nebo

Byla XmlWriter volána asynchronní metoda bez nastavení příznaku Async na true. V tomto případě je vyvolána se zprávou "Nastavit XmlWriterSettings.Async na true, InvalidOperationException pokud chcete použít asynchronní metody."

Poznámky

Jedná se o asynchronní verzi WriteSurrogateCharEntity, se stejnou funkcí. Chcete-li použít tuto metodu Async , je nutné nastavit příznak na true.

Tato metoda ukládá do úlohy všechny výjimky bez použití, které může vyvolat synchronní protějšek metody. Pokud je výjimka uložena do vrácené úlohy, tato výjimka bude vyvolána, když je úkol očekáván. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. V případě uložených výjimek se podívejte na výjimky vyvolané WriteSurrogateCharEntity(Char, Char).

Viz také

• Asynchronní programování (C#)
• Asynchronní programování pomocí Async a Await (Visual Basic)