StreamWriter.WriteLineAsync Method (String)
.NET Framework (current version)
Writes a string followed by a line terminator asynchronously to the stream.
Assembly: mscorlib (in mscorlib.dll)
[ComVisibleAttribute(false)] [HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)] public override Task WriteLineAsync( string value )
Parameters
- value
-
Type:
System.String
The string to write. If the value is null, only a line terminator is written.
Return Value
Type: System.Threading.Tasks.TaskA task that represents the asynchronous write operation.
| Exception | Condition |
|---|---|
| ObjectDisposedException | The stream writer is disposed. |
| InvalidOperationException | The stream writer is currently in use by a previous write operation. |
The line terminator is defined by the TextWriter.NewLine property.
The following example shows how to write two lines that consist of string values to a text file by using the WriteLineAsync(String) method.
using System; using System.IO; namespace ConsoleApplication { class Program { static void Main(string[] args) { WriteCharacters(); } static async void WriteCharacters() { using (StreamWriter writer = File.CreateText("newfile.txt")) { await writer.WriteLineAsync("First line of example"); await writer.WriteLineAsync("and second line"); } } } }
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: