StreamWriter.WriteLineAsync Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

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

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ısı ekler.
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)	Akışa zaman uyumsuz olarak bir karakter alt dizisini yazar ve ardından bir satır sonlandırıcısı 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ısı ekler.

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 istekleri için izlenecek 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

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 WriteLineAsync(Char) bir metin dosyasındaki bir satıra tek bir karakterin ("a" harfi) ve ardından tek bir karakter ("b" harfi) içeren başka bir satırın nasıl yazıldığını 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

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.

Ö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 WriteLineAsync(String) nasıl yazıldığını 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 atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan WriteLine(String)özel durumlara bakın.

WriteLineAsync(Char[], Int32, Int32)

Kaynak:

StreamWriter.cs

Akışa zaman uyumsuz olarak bir karakter alt dizisini yazar ve ardından bir satır sonlandırıcısı 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şlayabileceğiniz 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 değeridir.

ArgumentException

Artı indexcount , 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 ("İlk satır" ve ardından boşluk) içerir. İ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.