Aracılığıyla paylaş


StreamWriter.WriteAsync Yöntem

Tanım

Akışa zaman uyumsuz olarak veri yazar.

Aşırı Yüklemeler

WriteAsync(Char)

Akışa zaman uyumsuz olarak bir karakter yazar.

WriteAsync(String)

Akışa zaman uyumsuz olarak bir dize yazar.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Akışa zaman uyumsuz olarak bir karakter bellek bölgesi yazar.

WriteAsync(Char[], Int32, Int32)

Akışa zaman uyumsuz olarak bir karakter alt dizisi yazar.

WriteAsync(Char)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Akışa zaman uyumsuz olarak bir karakter yazar.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(char value);
public override System.Threading.Tasks.Task WriteAsync (char value);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteAsync (char value);
override this.WriteAsync : char -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteAsync : char -> System.Threading.Tasks.Task
Public Overrides Function WriteAsync (value As Char) As Task

Parametreler

value
Char

Akışa yazacak karakter.

Döndürülenler

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

Öznitelikler

Özel durumlar

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

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ına tek bir karakterin ("a" harfi) nasıl yazılacak gösterilmektedir WriteAsync(Char) .

using System.IO;

namespace ConsoleApplication
{
    class Program1
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteAsync('a');
            }
        }
    }
}
Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim oneLetter As Char = "a"
        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteAsync(oneLetter)
        End Using
    End Sub
End Module

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 Write(Char)özel durumlara bakın.

Şunlara uygulanır

WriteAsync(String)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Akışa zaman uyumsuz olarak bir dize yazar.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(System::String ^ value);
public override System.Threading.Tasks.Task WriteAsync (string value);
public override System.Threading.Tasks.Task WriteAsync (string? value);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteAsync (string value);
override this.WriteAsync : string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteAsync : string -> System.Threading.Tasks.Task
Public Overrides Function WriteAsync (value As String) As Task

Parametreler

value
String

Akışa yazacak dize. ise valuenull, hiçbir şey yazılmıştır.

Döndürülenler

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

Öznitelikler

Özel durumlar

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

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ına dize yazma işlemi gösterilmektedir WriteAsync(String) .

using System.IO;

namespace ConsoleApplication
{
    class Program2
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteAsync("Example text as string");
            }
        }
    }
}
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.WriteAsync("Example text as string")
        End Using
    End Sub
End Module

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 Write(String)özel durumlara bakın.

Şunlara uygulanır

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Akışa zaman uyumsuz olarak bir karakter bellek bölgesi yazar.

public override System.Threading.Tasks.Task WriteAsync (ReadOnlyMemory<char> buffer, System.Threading.CancellationToken cancellationToken = default);
override this.WriteAsync : ReadOnlyMemory<char> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function WriteAsync (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ç. None varsayılan değerdir.

Döndürülenler

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

Özel durumlar

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

Şunlara uygulanır

WriteAsync(Char[], Int32, Int32)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Akışa zaman uyumsuz olarak bir karakter alt dizisi yazar.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <char> ^ buffer, int index, int count);
public override System.Threading.Tasks.Task WriteAsync (char[] buffer, int index, int count);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task WriteAsync (char[] buffer, int index, int count);
override this.WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.WriteAsync : char[] * int * int -> System.Threading.Tasks.Task
Public Overrides Function WriteAsync (buffer As Char(), index As Integer, count As Integer) As Task

Parametreler

buffer
Char[]

Yazacak verileri içeren bir 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

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

Öznitelikler

Özel durumlar

buffer, null değeridir.

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

index veya count negatiftir.

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

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ına birden çok karakter yazma işlemi gösterilmektedir WriteAsync(Char[], Int32, Int32) .

using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program5
    {
        static void Main()
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            UnicodeEncoding ue = new UnicodeEncoding();
            char[] charsToAdd = ue.GetChars(ue.GetBytes("Example string"));
            using (StreamWriter writer = File.CreateText("newfile.txt"))
            {
                await writer.WriteAsync(charsToAdd, 0, charsToAdd.Length);
            }
        }
    }
}
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("Example string"))

        Using writer As StreamWriter = File.CreateText("newfile.txt")
            Await writer.WriteAsync(charsToAdd, 0, charsToAdd.Length)
        End Using
    End Sub
End Module

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 Write(Char[], Int32, Int32)özel durumlara bakın.

Şunlara uygulanır