StringWriter.WriteLineAsync 方法

参考

定义

命名空间:: System.IO

程序集:: System.Runtime.dll

程序集:: System.Runtime.Extensions.dll

程序集:: System.IO.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将数据异步写入字符串，后跟行终止符。

重载

WriteLineAsync(StringBuilder, CancellationToken)	将字符串生成器的字符串表示形式异步写入当前字符串，后跟行终止符。
WriteLineAsync(Char)	将字符异步写入字符串，后跟行终止符。
WriteLineAsync(String)	将字符串异步写入当前字符串，后跟行终止符。
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	将字符内存区域的字符串表示形式异步写入当前字符串，后跟行终止符。
WriteLineAsync(Char[], Int32, Int32)	将字符的子数组异步写入字符串，后跟行终止符。

WriteLineAsync(StringBuilder, CancellationToken)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

将字符串生成器的字符串表示形式异步写入当前字符串，后跟行终止符。

public override System.Threading.Tasks.Task WriteLineAsync (System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);

override this.WriteLineAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

参数

value: StringBuilder

要写入字符串的字符串生成器。

cancellationToken: CancellationToken

要监视取消请求的标记。默认值为 None。

Task

表示异步写入操作的任务。

例外

OperationCanceledException

取消令牌已取消。此异常存储在返回的任务中。

注解

此方法将存储在任务中，它返回该方法的同步对应项可能引发的所有非使用异常。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。有关存储的异常，请参阅引发的 WriteLine(StringBuilder)异常。

适用于

WriteLineAsync(Char)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

将字符异步写入字符串，后跟行终止符。

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(char value);

public override System.Threading.Tasks.Task WriteLineAsync (char value);

[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync (char value);

override this.WriteLineAsync : char -> System.Threading.Tasks.Task

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteLineAsync : char -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (value As Char) As Task

参数

value: Char

要写入字符串中的字符。

Task

表示异步写入操作的任务。

属性: ComVisibleAttribute

例外

ObjectDisposedException

已释放字符串编写器。

InvalidOperationException

字符串编写器正在由前一个写操作使用。

示例

以下示例演示如何使用 WriteLineAsync(Char) 方法编写字符。

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.WriteLineAsync(c);
                }
                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// a
// n
// d
//
// c
// h
// a
// r
// s
//
// t
// o
//
// a
// d
// d
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)

            Dim ue As UnicodeEncoding = New UnicodeEncoding()
            Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))
            For Each c As Char In charsToAdd
                Await writer.WriteLineAsync(c)
            Next
            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' a
' n
' d 
'
' c
' h
' a
' r
' s
' 
' t
' o
'
' a
' d
' d
'

注解

行终止符由 NewLine 属性定义。

适用于

WriteLineAsync(String)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

将字符串异步写入当前字符串，后跟行终止符。

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value);

public override System.Threading.Tasks.Task WriteLineAsync (string value);

public override System.Threading.Tasks.Task WriteLineAsync (string? value);

[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync (string value);

override this.WriteLineAsync : string -> System.Threading.Tasks.Task

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteLineAsync : string -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (value As String) As Task

参数

value: String

要写入的字符串。如果值为 null，则只写入行终止符。

Task

表示异步写入操作的任务。

属性: ComVisibleAttribute

例外

ObjectDisposedException

已释放字符串编写器。

InvalidOperationException

字符串编写器正在由前一个写操作使用。

示例

以下示例演示如何使用 WriteLineAsync(String) 方法编写字符串。

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))
            {
                await writer.WriteLineAsync("and add characters through StringWriter");
                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and add characters through StringWriter
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)
            Await writer.WriteLineAsync("and add characters through StringWriter")
            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' and add characters through StringWriter
'

注解

行终止符由 NewLine 属性定义。

适用于

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

将字符内存区域的字符串表示形式异步写入当前字符串，后跟行终止符。

public override System.Threading.Tasks.Task WriteLineAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (buffer As ReadOnlyMemory(Of Char), Optional cancellationToken As CancellationToken = Nothing) As Task

参数

buffer: ReadOnlyMemory<Char>

要写入字符串中的字符内存区域。

cancellationToken: CancellationToken

要监视取消请求的标记。默认值为 None。

Task

表示异步写入操作的任务。

例外

OperationCanceledException

取消令牌已取消。此异常存储在返回的任务中。

适用于

WriteLineAsync(Char[], Int32, Int32)

Source:: StringWriter.cs

Source:: StringWriter.cs

Source:: StringWriter.cs

将字符的子数组异步写入字符串，后跟行终止符。

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <char> ^ buffer, int index, int count);

public override System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);

[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);

override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteLineAsync : char[] * int * int -> System.Threading.Tasks.Task

Public Overrides Function WriteLineAsync (buffer As Char(), index As Integer, count As Integer) As Task

参数

buffer: Char[]

要从中写出数据的字符数组。

index: Int32

缓冲区中开始读取数据的位置。

count: Int32

要写入的最大字符数。

Task

表示异步写入操作的任务。

属性: ComVisibleAttribute

例外

ArgumentNullException

buffer 为 null。

ArgumentException

index 加 count 大于缓冲区长度。

ArgumentOutOfRangeException

index 或 count 为负数。

ObjectDisposedException

已释放字符串编写器。

InvalidOperationException

字符串编写器正在由前一个写操作使用。

示例

以下示例演示如何使用 WriteLineAsync(Char[], Int32, Int32) 方法编写字符。

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"));

                await writer.WriteLineAsync(charsToAdd, 0, charsToAdd.Length);

                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and chars to add
//

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)

            Dim ue As UnicodeEncoding = New UnicodeEncoding()
            Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))

            Await writer.WriteLineAsync(charsToAdd, 0, charsToAdd.Length)

            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' The example displays the following output:
'
' Characters in StringBuilder
' and chars to add
'

注解

行终止符由 NewLine 属性定义。

适用于

通过

StringWriter.WriteLineAsync 方法

定义

重载

WriteLineAsync(StringBuilder, CancellationToken)

参数

返回

例外

注解

适用于

WriteLineAsync(Char)

参数

返回

例外

示例

注解

适用于

WriteLineAsync(String)

参数

返回

例外

示例

注解

适用于

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

参数

返回

例外

适用于

WriteLineAsync(Char[], Int32, Int32)

参数

返回

例外

示例

注解

适用于

其他资源