StreamWriter.WriteLineAsync Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

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

Aşırı Yüklemeler

Name	Description
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Bir karakter bellek bölgesinin metin gösterimini akışa zaman uyumsuz olarak yazar ve ardından bir satır sonlandırıcı yazar.
WriteLineAsync()	Akışa zaman uyumsuz olarak bir satır sonlandırıcı yazar.
WriteLineAsync(Char)	Zaman uyumsuz olarak akışa bir karakter yazar ve ardından bir satır sonlandırıcısı ekler.
WriteLineAsync(String)	Zaman uyumsuz olarak akışa bir dize yazar ve ardından bir satır sonlandırıcısı ekler.
WriteLineAsync(Char[], Int32, Int32)	Zaman uyumsuz olarak akışa karakterlerin alt dizisini ve ardından bir satır sonlandırıcı yazar.

WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)

Kaynak:

StreamWriter.cs

Bir karakter bellek bölgesinin metin gösterimini akışa zaman uyumsuz olarak yazar ve ardından bir satır sonlandırıcı yazar.

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>

Akışa yazacak karakter bellek bölgesi.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. Varsayılan değer None değeridir.

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

Satır sonlandırıcı alanı tarafından CoreNewLine tanımlanır.

WriteLineAsync()

Kaynak:

StreamWriter.cs

Akışa zaman uyumsuz olarak bir satır sonlandırıcı yazar.

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

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

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

Public Overrides Function WriteLineAsync () As Task

Döndürülenler

Task

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

Özel durumlar

ObjectDisposedException

Akış yazıcısı atılır.

InvalidOperationException

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

Açıklamalar

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

WriteLineAsync(Char)

Kaynak:

StreamWriter.cs

Zaman uyumsuz olarak akışa 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);

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

Public Overrides Function WriteLineAsync (value As Char) As Task

Parametreler

value

Char

Akışa yazacak karakter.

Döndürülenler

Task

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

Özel durumlar

ObjectDisposedException

Akış yazıcısı atılır.

InvalidOperationException

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

Örnekler

Aşağıdaki örnekte, yöntemini kullanarak bir metin dosyasındaki bir satıra tek bir karakterin ("a" harfi) ve ardından tek bir karakter içeren başka bir satırın ("b" harfi) nasıl yazıldığını WriteLineAsync(Char) gösterir.

using System.IO;

namespace ConsoleApplication
{
    class Program3
    {
        static void Main()
        {
            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

Açıklamalar

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

WriteLineAsync(String)

Kaynak:

StreamWriter.cs

Zaman uyumsuz olarak akışa 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);

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

Public Overrides Function WriteLineAsync (value As String) As Task

Parametreler

value

String

Yazacak 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.

Özel durumlar

ObjectDisposedException

Akış yazıcısı atılır.

InvalidOperationException

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

Örnekler

Aşağıdaki örnek, yöntemini kullanarak bir metin dosyasına dize değerlerinden oluşan iki satırın nasıl yazıldığını WriteLineAsync(String) gösterir.

using System.IO;

namespace ConsoleApplication
{
    class Program4
    {
        static void Main()
        {
            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

Açıklamalar

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

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından WriteLine(String)oluşan özel durumlara bakın.

WriteLineAsync(Char[], Int32, Int32)

Kaynak:

StreamWriter.cs

Zaman uyumsuz olarak akışa karakterlerin alt dizisini ve ardından bir satır sonlandırıcı yazar.

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

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şlanması gereken karakter konumu.

count

Int32

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

Döndürülenler

Task

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

Özel durumlar

ArgumentNullException

buffer, null'e eşittir.

ArgumentException

index artı count arabellek uzunluğundan büyüktür.

ArgumentOutOfRangeException

index veya count negatiftir.

ObjectDisposedException

Akış yazıcısı atılır.

InvalidOperationException

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

Örnekler

Aşağıdaki örnekte, yöntemini kullanarak bir metin dosyasındaki iki ayrı satıra karakter yazma işlemi gösterilmektedir WriteLineAsync(Char[], Int32, Int32) . İlk satır dizeden ilk 11 karakteri içerir ("İlk satır" harfleri ve ardından boşluk). İkinci satır dizeden kalan karakterleri ("ve ikinci satır" harfleri) içerir.

using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program6
    {
        static void Main()
        {
            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

Açıklamalar

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