StreamWriter::WriteLineAsync Method (String^)

.NET Framework (current version)

Writes a string followed by a line terminator asynchronously to the stream.

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

Syntax

public:
[ComVisibleAttribute(false)]
[HostProtectionAttribute(SecurityAction::LinkDemand, ExternalThreading = true)]
virtual Task^ WriteLineAsync(
	String^ value
) override

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::Task^

A task that represents the asynchronous write operation.

Exceptions

Exception	Condition
ObjectDisposedException	The stream writer is disposed.
InvalidOperationException	The stream writer is currently in use by a previous write operation.

Remarks

The line terminator is defined by the TextWriter::NewLine property.

Examples

The following example shows how to write two lines that consist of string values to a text file by using the WriteLineAsync(String^) method.

C++

No code example is currently available or this language may not be supported.

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