StreamWriter.WriteLineAsync StreamWriter.WriteLineAsync StreamWriter.WriteLineAsync StreamWriter.WriteLineAsync Method

定義

以非同步方式將資料寫入資料流,後接行結束字元。Asynchronously writes data to the stream, followed by a line terminator.

多載

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

以非同步方式將字元記憶體區域的文字表示寫入資料流,後接行結束字元。Asynchronously writes the text representation of a character memory region to the stream, followed by a line terminator.

WriteLineAsync() WriteLineAsync() WriteLineAsync() WriteLineAsync()

以非同步方式將行結束字元寫入資料流。Asynchronously writes a line terminator to the stream.

WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char)

以非同步方式將字元寫入資料流,後接行結束字元。Asynchronously writes a character to the stream, followed by a line terminator.

WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String)

以非同步方式將字串寫入資料流,後接行結束字元。Asynchronously writes a string to the stream, followed by a line terminator.

WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32)

以非同步方式將字元的子陣列寫入資料流,後接行結束字元。Asynchronously writes a subarray of characters to the stream, followed by a line terminator.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken) WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

以非同步方式將字元記憶體區域的文字表示寫入資料流,後接行結束字元。Asynchronously writes the text representation of a character memory region to the stream, followed by a line terminator.

public override System.Threading.Tasks.Task WriteLineAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = null);
override this.WriteLineAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

參數

buffer
ReadOnlyMemory<Char>

要寫入資料流的字元記憶體區域。The character memory region to write to the stream.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

用來監視是否有取消要求的語彙基元。The token to monitor for cancellation requests. 預設值為 NoneThe default value is None.

傳回

表示非同步寫入作業的工作。A task that represents the asynchronous write operation.

備註

行結束字元是由 CoreNewLine 欄位所定義。The line terminator is defined by the CoreNewLine field.

WriteLineAsync() WriteLineAsync() WriteLineAsync() WriteLineAsync()

以非同步方式將行結束字元寫入資料流。Asynchronously writes a line terminator to the stream.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync();
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync ();
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task
Public Overrides Function WriteLineAsync () As Task

傳回

表示非同步寫入作業的工作。A task that represents the asynchronous write operation.

例外狀況

資料流寫入器已處置。The stream writer is disposed.

資料流寫入器目前由先前寫入作業所使用。The stream writer is currently in use by a previous write operation.

備註

行結束字元是由TextWriter.NewLine屬性所定義。The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char) WriteLineAsync(Char)

以非同步方式將字元寫入資料流,後接行結束字元。Asynchronously writes a character to the stream, followed by a line terminator.

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
Public Overrides Function WriteLineAsync (value As Char) As Task

參數

value
Char Char Char Char

要寫入至資料流的字元。The character to write to the stream.

傳回

表示非同步寫入作業的工作。A task that represents the asynchronous write operation.

例外狀況

資料流寫入器已處置。The stream writer is disposed.

資料流寫入器目前由先前寫入作業所使用。The stream writer is currently in use by a previous write operation.

範例

下列範例顯示如何使用WriteLineAsync(Char)方法,將單一字元(字母 "a")寫入文字檔中的行,後面接著另一行包含單一字元(字母 "b")。The following example shows how to write a single character (the letter "a") to a line in a text file, followed by another line that contains a single character (the letter "b"), by using the WriteLineAsync(Char) 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('a');
                await writer.WriteLineAsync('b');
            }
        }
    }
}
Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim firstChar As Char = "a"
        Dim secondChar As Char = "b"
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync(firstChar)
            Await writer.WriteLineAsync(secondChar)
        End Using
    End Sub
End Module

備註

行結束字元是由TextWriter.NewLine屬性所定義。The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String) WriteLineAsync(String)

以非同步方式將字串寫入資料流,後接行結束字元。Asynchronously writes a string to the stream, followed by a line terminator.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(System::String ^ value);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync (string value);
override this.WriteLineAsync : string -> System.Threading.Tasks.Task
Public Overrides Function WriteLineAsync (value As String) As Task

參數

value
String String String String

要寫入的字串。The string to write. 如果值為 null,則只會寫入行結束字元。If the value is null, only a line terminator is written.

傳回

表示非同步寫入作業的工作。A task that represents the asynchronous write operation.

例外狀況

資料流寫入器已處置。The stream writer is disposed.

資料流寫入器目前由先前寫入作業所使用。The stream writer is currently in use by a previous write operation.

範例

下列範例顯示如何使用WriteLineAsync(String)方法,將包含字串值的兩行寫入文字檔。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");
            }
        }
    }
}
Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync("First line of example")
            Await writer.WriteLineAsync("and second line")
        End Using
    End Sub
End Module

備註

行結束字元是由TextWriter.NewLine屬性所定義。The line terminator is defined by the TextWriter.NewLine property.

WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32) WriteLineAsync(Char[], Int32, Int32)

以非同步方式將字元的子陣列寫入資料流,後接行結束字元。Asynchronously writes a subarray of characters to the stream, followed by a line terminator.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(cli::array <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
Public Overrides Function WriteLineAsync (buffer As Char(), index As Integer, count As Integer) As Task

參數

buffer
Char[]

資料寫入來源的字元陣列。The character array to write data from.

index
Int32 Int32 Int32 Int32

緩衝區中要開始讀取資料的字元位置。The character position in the buffer at which to start reading data.

count
Int32 Int32 Int32 Int32

要寫入的最大字元數。The maximum number of characters to write.

傳回

表示非同步寫入作業的工作。A task that represents the asynchronous write operation.

例外狀況

index 加上 count 大於緩衝區長度。The index plus count is greater than the buffer length.

資料流寫入器已處置。The stream writer is disposed.

資料流寫入器目前由先前寫入作業所使用。The stream writer is currently in use by a previous write operation.

範例

下列範例示範如何使用WriteLineAsync(Char[], Int32, Int32)方法,在文字檔中將字元寫入兩個不同的行。The following example shows how to write characters to two separate lines in a text file by using the WriteLineAsync(Char[], Int32, Int32) method. 第一行包含字串中的前11個字元(字母「第一行」後面接著一個空格)。The first line contains the first 11 characters from the string (the letters "First line" followed by a space). 第二行包含字串中剩餘的字元(字母「和第二行」)。The second line contains the remaining characters from the string (the letters "and second line").

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            UnicodeEncoding ue = new UnicodeEncoding();
            char[] charsToAdd = ue.GetChars(ue.GetBytes("First line and second line"));
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteLineAsync(charsToAdd, 0, 11);
                await writer.WriteLineAsync(charsToAdd, 11, charsToAdd.Length - 11);
            }
        }
    }
}
Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim ue As UnicodeEncoding = New UnicodeEncoding()
        Dim charsToAdd() = ue.GetChars(ue.GetBytes("First line and second line"))

        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteLineAsync(charsToAdd, 0, 11)
            Await writer.WriteLineAsync(charsToAdd, 11, charsToAdd.Length - 11)
        End Using
    End Sub
End Module

備註

行結束字元是由TextWriter.NewLine屬性所定義。The line terminator is defined by the TextWriter.NewLine property.

適用於