StringWriter.WriteAsync Method (String)

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Writes a string to the current string asynchronously.

Namespace:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public override Task WriteAsync(
	string value


Type: System.String

The string to write. If value is null, nothing is written to the text stream.

Return Value

Type: System.Threading.Tasks.Task

A task that represents the asynchronous write operation.

Exception Condition

The string writer is disposed.


The string writer is currently in use by a previous write operation.

The following example shows how to write a string by using the WriteAsync(String) method.

using System;
using System.Text;
using System.IO;

namespace ConsoleApplication
    class Program
        static void Main(string[] args)

        static async void WriteCharacters()
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");

            using (StringWriter writer = new StringWriter(stringToWrite))
                await writer.WriteAsync("and add characters through StringWriter");
// The example displays the following output:
// Characters in StringBuilder
// and add characters through StringWriter

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
Return to top