StringWriter.WriteLineAsync Methode

Definitie

Naamruimte:: System.IO

Assembly's:: mscorlib.dll, System.IO.dll

Assembly:: mscorlib.dll

Assembly:: System.IO.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Asynchroon schrijft gegevens naar de tekenreeks, gevolgd door een regeleindteken.

Overloads

Name	Description
WriteLineAsync(Char)	Asynchroon schrijft een teken naar de tekenreeks, gevolgd door een regeleindteken.
WriteLineAsync(String)	Asynchroon schrijft een tekenreeks naar de huidige tekenreeks, gevolgd door een regeleindteken.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Asynchroon schrijft de tekenreeksweergave van het geheugengebied van tekens naar de huidige tekenreeks, gevolgd door een regeleindteken.
WriteLineAsync(Char[], Int32, Int32)	asynchroon schrijft een submaarray van tekens naar de tekenreeks, gevolgd door een regeleindteken.

WriteLineAsync(Char)

Asynchroon schrijft een teken naar de tekenreeks, gevolgd door een regeleindteken.

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

Parameters

value: Char

Het teken dat naar de tekenreeks moet worden geschreven.

Retouren

Task

Een taak die de asynchrone schrijfbewerking vertegenwoordigt.

Kenmerken: ComVisibleAttribute

Uitzonderingen

ObjectDisposedException

De tekenreeksschrijver wordt verwijderd.

InvalidOperationException

De tekenreeksschrijver wordt momenteel gebruikt door een eerdere schrijfbewerking.

Voorbeelden

In het volgende voorbeeld ziet u hoe u tekens schrijft met behulp van de WriteLineAsync(Char) methode.

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
'

Opmerkingen

De regeleindteken wordt gedefinieerd door de NewLine eigenschap.

Van toepassing op

WriteLineAsync(String)

Asynchroon schrijft een tekenreeks naar de huidige tekenreeks, gevolgd door een regeleindteken.

public:
 override System::Threading::Tasks::Task ^ WriteLineAsync(System::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

Parameters

value: String

De tekenreeks die moet worden geschreven. Als de waarde is, wordt nullalleen een regeleindteken geschreven.

Retouren

Task

Een taak die de asynchrone schrijfbewerking vertegenwoordigt.

Kenmerken: ComVisibleAttribute

Uitzonderingen

ObjectDisposedException

De tekenreeksschrijver wordt verwijderd.

InvalidOperationException

De tekenreeksschrijver wordt momenteel gebruikt door een eerdere schrijfbewerking.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een tekenreeks schrijft met behulp van de WriteLineAsync(String) methode.

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
'

Opmerkingen

De regeleindteken wordt gedefinieerd door de NewLine eigenschap.

Van toepassing op

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Asynchroon schrijft de tekenreeksweergave van het geheugengebied van tekens naar de huidige tekenreeks, gevolgd door een regeleindteken.

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

Parameters

buffer: ReadOnlyMemory<Char>

Een geheugengebied met tekens om naar de tekenreeks te schrijven.

cancellationToken: CancellationToken

Het token dat moet worden gecontroleerd op annuleringsaanvragen. De standaardwaarde is None.

Retouren

Task

Een taak die de asynchrone schrijfbewerking vertegenwoordigt.

Uitzonderingen

OperationCanceledException

Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.

Van toepassing op

WriteLineAsync(Char[], Int32, Int32)

asynchroon schrijft een submaarray van tekens naar de tekenreeks, gevolgd door een regeleindteken.

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

Parameters

buffer: Char[]

De tekenmatrix waaruit gegevens moeten worden geschreven.

index: Int32

De positie in de buffer waar gegevens moeten worden gelezen.

count: Int32

Het maximum aantal tekens dat moet worden geschreven.

Retouren

Task

Een taak die de asynchrone schrijfbewerking vertegenwoordigt.

Kenmerken: ComVisibleAttribute

Uitzonderingen

ArgumentNullException

buffer is null.

ArgumentException

Het index plusteken count is groter dan de bufferlengte.

ArgumentOutOfRangeException

index of count is negatief.

ObjectDisposedException

De tekenreeksschrijver wordt verwijderd.

InvalidOperationException

De tekenreeksschrijver wordt momenteel gebruikt door een eerdere schrijfbewerking.

Voorbeelden

In het volgende voorbeeld ziet u hoe u tekens schrijft met behulp van de WriteLineAsync(Char[], Int32, Int32) methode.

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
'

Opmerkingen

De regeleindteken wordt gedefinieerd door de NewLine eigenschap.

Van toepassing op

Feedback

Is deze pagina nuttig?