StringWriter.WriteLineAsync Yöntem

Başvuru

Tanım

Ad Alanı:: System.IO

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: System.Runtime.Extensions.dll

Bütünleştirilmiş Kod:: System.IO.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Zaman uyumsuz olarak dizeye veri yazar ve ardından bir satır sonlandırıcısı ekler.

Aşırı Yüklemeler

WriteLineAsync(StringBuilder, CancellationToken)	Dize oluşturucusunun dize gösterimini geçerli dizeye zaman uyumsuz olarak yazar ve ardından bir satır sonlandırıcısı ekler.
WriteLineAsync(Char)	Zaman uyumsuz olarak dizeye bir karakter yazar ve ardından bir satır sonlandırıcısı ekler.
WriteLineAsync(String)	Geçerli dizeye zaman uyumsuz olarak bir dize yazar ve ardından bir satır sonlandırıcısı ekler.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Karakterlerin bellek bölgesinin dize gösterimini geçerli dizeye zaman uyumsuz olarak yazar ve bunu bir satır sonlandırıcısı izler.
WriteLineAsync(Char[], Int32, Int32)	zaman uyumsuz olarak dizeye karakterlerin alt dizisini yazar ve ardından bir satır sonlandırıcısı ekler.

WriteLineAsync(StringBuilder, CancellationToken)

Kaynak:: StringWriter.cs

Kaynak:: StringWriter.cs

Kaynak:: StringWriter.cs

Dize oluşturucusunun dize gösterimini geçerli dizeye zaman uyumsuz olarak yazar ve ardından bir satır sonlandırıcısı ekler.

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

Parametreler

value: StringBuilder

Dizeye yazacak dize oluşturucu.

cancellationToken: CancellationToken

İptal isteklerini izlemek için belirteç. None varsayılan değerdir.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan WriteLine(StringBuilder)özel durumlara bakın.

Şunlara uygulanır

WriteLineAsync(Char)

Kaynak:: StringWriter.cs

Kaynak:: StringWriter.cs

Kaynak:: StringWriter.cs

Zaman uyumsuz olarak dizeye bir karakter yazar ve ardından bir satır sonlandırıcısı ekler.

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

Parametreler

value: Char

Dizeye yazacak karakter.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Öznitelikler: ComVisibleAttribute

Özel durumlar

ObjectDisposedException

Dize yazıcısı atılır.

InvalidOperationException

Dize yazıcısı şu anda önceki bir yazma işlemi tarafından kullanılıyor.

Örnekler

Aşağıdaki örnekte, yöntemini kullanarak karakter yazma işlemi gösterilmektedir 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
'

Açıklamalar

Satır sonlandırıcı özelliği tarafından NewLine tanımlanır.

Şunlara uygulanır

WriteLineAsync(String)

Kaynak:: StringWriter.cs

Kaynak:: StringWriter.cs

Kaynak:: StringWriter.cs

Geçerli dizeye zaman uyumsuz olarak bir dize yazar ve ardından bir satır sonlandırıcısı ekler.

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

Parametreler

value: String

Yazılacak dize. Değer ise null, yalnızca bir satır sonlandırıcı yazılır.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Öznitelikler: ComVisibleAttribute

Özel durumlar

ObjectDisposedException

Dize yazıcısı atılır.

InvalidOperationException

Dize yazıcısı şu anda önceki bir yazma işlemi tarafından kullanılıyor.

Örnekler

Aşağıdaki örnekte yöntemini kullanarak bir dize yazma işlemi gösterilmektedir 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
'

Açıklamalar

Satır sonlandırıcı özelliği tarafından NewLine tanımlanır.

Şunlara uygulanır

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Kaynak:: StringWriter.cs

Kaynak:: StringWriter.cs

Kaynak:: StringWriter.cs

Karakterlerin bellek bölgesinin dize gösterimini geçerli dizeye zaman uyumsuz olarak yazar ve bunu bir satır sonlandırıcısı izler.

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

Parametreler

buffer: ReadOnlyMemory<Char>

Dizeye yazacak karakterlerin bellek bölgesi.

cancellationToken: CancellationToken

İptal isteklerini izlemek için belirteç. None varsayılan değerdir.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Şunlara uygulanır

WriteLineAsync(Char[], Int32, Int32)

Kaynak:: StringWriter.cs

Kaynak:: StringWriter.cs

Kaynak:: StringWriter.cs

zaman uyumsuz olarak dizeye karakterlerin alt dizisini yazar ve ardından bir satır sonlandırıcısı ekler.

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

Parametreler

buffer: Char[]

Veri yazacak karakter dizisi.

index: Int32

Arabellekte verileri okumaya başlayabileceğiniz konum.

count: Int32

Yazacak karakter sayısı üst sınırı.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Öznitelikler: ComVisibleAttribute

Özel durumlar

ArgumentNullException

buffer, null değeridir.

ArgumentException

Artı indexcount , arabellek uzunluğundan daha büyüktür.

ArgumentOutOfRangeException

index veya count negatiftir.

ObjectDisposedException

Dize yazıcısı atılır.

InvalidOperationException

Dize yazıcısı şu anda önceki bir yazma işlemi tarafından kullanılıyor.

Örnekler

Aşağıdaki örnekte, yöntemini kullanarak karakter yazma işlemi gösterilmektedir 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
'

Açıklamalar

Satır sonlandırıcı özelliği tarafından NewLine tanımlanır.

Şunlara uygulanır

Aracılığıyla paylaş

StringWriter.WriteLineAsync Yöntem

Tanım

Aşırı Yüklemeler

WriteLineAsync(StringBuilder, CancellationToken)

Parametreler

Döndürülenler

Özel durumlar

Açıklamalar

Şunlara uygulanır

WriteLineAsync(Char)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

WriteLineAsync(String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Parametreler

Döndürülenler

Özel durumlar

Şunlara uygulanır

WriteLineAsync(Char[], Int32, Int32)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Ek kaynaklar