StreamWriter.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:
netstandard.dll
Bütünleştirilmiş Kod:
System.IO.dll
Bütünleştirilmiş Kod:
mscorlib.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
Kaynak:
StreamWriter.cs
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.

Şunlara uygulanır

WriteLineAsync()

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
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 ();
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteLineAsync ();
override this.WriteLineAsync : unit -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
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.

Öznitelikler
ComVisibleAttribute

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

Şunlara uygulanır

WriteLineAsync(Char)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
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);
[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

Akışa yazacak karakter.

Döndürülenler

Task

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

Öznitelikler
ComVisibleAttribute

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

Şunlara uygulanır

WriteLineAsync(String)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
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);
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

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.

Şunlara uygulanır

WriteLineAsync(Char[], Int32, Int32)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
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);
[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 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.

Öznitelikler
ComVisibleAttribute

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

Şunlara uygulanır