StringWriter.WriteAsync Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Verileri dizeye zaman uyumsuz olarak yazar.

Aşırı Yüklemeler

WriteAsync(Char)	Dizeye zaman uyumsuz olarak bir karakter yazar.
WriteAsync(String)	Geçerli dizeye zaman uyumsuz olarak bir dize yazar.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Dizeye karakterlerin bellek bölgesini zaman uyumsuz olarak yazar.
WriteAsync(StringBuilder, CancellationToken)	Dize oluşturucusunun metin gösterimini zaman uyumsuz olarak dizeye yazar.
WriteAsync(Char[], Int32, Int32)	Dizeye zaman uyumsuz olarak karakter alt dizisini yazar.

WriteAsync(Char)

Kaynak:

StringWriter.cs

Dizeye zaman uyumsuz olarak bir karakter yazar.

C#

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

Parametreler

value

Char

Dizeye yazacak karakter.

Döndürülenler

Task

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

Özel durumlar

ObjectDisposedException

Dize yazıcısı atılır.

InvalidOperationException

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

Örnekler

Aşağıdaki örnekte, yöntemini kullanarak karakter yazma işlemi gösterilmektedir WriteAsync(Char) .

C#

using System;
using System.Text;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                UnicodeEncoding ue = new UnicodeEncoding();
                char[] charsToAdd = ue.GetChars(ue.GetBytes("and chars to add"));
                foreach (char c in charsToAdd)
                {
                    await writer.WriteAsync(c);
                }
                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and chars to add
//

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.

WriteAsync(String)

Kaynak:

StringWriter.cs

Geçerli dizeye zaman uyumsuz olarak bir dize yazar.

C#

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

Parametreler

value

String

Yazılacak dize. ise valuenull, metin akışına hiçbir şey yazılır.

Döndürülenler

Task

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

Özel durumlar

ObjectDisposedException

Dize yazıcısı atılır.

InvalidOperationException

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

Örnekler

Aşağıdaki örnekte yöntemini kullanarak bir dize yazma işlemi gösterilmektedir WriteAsync(String) .

C#

using System;
using System.Text;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                await writer.WriteAsync("and add characters through StringWriter");
                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and add characters through StringWriter
//

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.

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Kaynak:

StringWriter.cs

Dizeye karakterlerin bellek bölgesini zaman uyumsuz olarak yazar.

C#

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

Parametreler

buffer

ReadOnlyMemory<Char>

Dizeye yazacak karakter bellek bölgesi.

cancellationToken

CancellationToken

İptal isteklerini izlemek için 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.

WriteAsync(StringBuilder, CancellationToken)

Kaynak:

StringWriter.cs

Dize oluşturucusunun metin gösterimini zaman uyumsuz olarak dizeye yazar.

C#

public override System.Threading.Tasks.Task WriteAsync (System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);

Parametreler

value

StringBuilder

Dizeye yazacak dize oluşturucu.

cancellationToken

CancellationToken

İptal isteklerini izlemek için 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

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

WriteAsync(Char[], Int32, Int32)

Kaynak:

StringWriter.cs

Dizeye zaman uyumsuz olarak karakter alt dizisini yazar.

C#

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

Parametreler

buffer

Char[]

Veri yazacak karakter dizisi.

index

Int32

Arabellekte verileri okumaya başlayabileceğiniz konum.

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 daha büyüktür.

ArgumentOutOfRangeException

index veya count negatiftir.

ObjectDisposedException

Dize yazıcısı atılır.

InvalidOperationException

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

Örnekler

Aşağıdaki örnekte, yöntemini kullanarak karakter yazma işlemi gösterilmektedir WriteAsync(Char[], Int32, Int32) .

C#

using System;
using System.Text;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            WriteCharacters();
        }

        static async void WriteCharacters()
        {
            StringBuilder stringToWrite = new StringBuilder("Characters in StringBuilder");
            stringToWrite.AppendLine();

            using (StringWriter writer = new StringWriter(stringToWrite))
            {
                UnicodeEncoding ue = new UnicodeEncoding();
                char[] charsToAdd = ue.GetChars(ue.GetBytes("and chars to add"));

                await writer.WriteAsync(charsToAdd, 0, charsToAdd.Length);

                Console.WriteLine(stringToWrite.ToString());
            }
        }
    }
}
// The example displays the following output:
//
// Characters in StringBuilder
// and chars to add
//

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.