StringWriter.WriteAsync Method (Char)
.NET Framework (current version)
Writes a character to the string asynchronously.
Assembly: mscorlib (in mscorlib.dll)
[ComVisibleAttribute(false)] [HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)] public override Task WriteAsync( char value )
Parameters
- value
-
Type:
System.Char
The character to write to the string.
Return Value
Type: System.Threading.Tasks.TaskA task that represents the asynchronous write operation.
| Exception | Condition |
|---|---|
| ObjectDisposedException | The string writer is disposed. |
| InvalidOperationException | The string writer is currently in use by a previous write operation. |
The following example shows how to write characters by using the WriteAsync(Char) method.
using System; using System.Text; using System.IO; namespace ConsoleApplication { class Program { static void Main(string[] args) { WriteCharacters(); } static async void WriteCharacters() { StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder"); stringToWrite.AppendLine(); using (StringWriter writer = new StringWriter(stringToWrite)) { UnicodeEncoding ue = new UnicodeEncoding(); char[] charsToAdd = ue.GetChars(ue.GetBytes("and chars to add")); foreach (char c in charsToAdd) { await writer.WriteAsync(c); } Console.WriteLine(stringToWrite.ToString()); } } } } // The example displays the following output: // // Characters in StringBuilder // and chars to add //
Universal Windows Platform
Available since 8
.NET Framework
Available since 4.5
Portable Class Library
Supported in: portable .NET platforms
Windows Phone Silverlight
Available since 8.0
Windows Phone
Available since 8.1
Available since 8
.NET Framework
Available since 4.5
Portable Class Library
Supported in: portable .NET platforms
Windows Phone Silverlight
Available since 8.0
Windows Phone
Available since 8.1
Show: