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.

C#

public override System.Threading.Tasks.Task WriteLineAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);

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.

C#

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

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.

C#

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

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.

C#

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

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.

C#

public override System.Threading.Tasks.Task WriteLineAsync (string? value);

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.

C#

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

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.

C#

public override System.Threading.Tasks.Task WriteLineAsync (char[] buffer, int index, int count);

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.

C#

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

Açıklamalar

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