Aracılığıyla paylaş


StringWriter.WriteAsync Yöntem

Tanım

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
Kaynak:
StringWriter.cs
Kaynak:
StringWriter.cs

Dizeye 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

Dizeye yazacak karakter.

Döndürülenler

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

Öznitelikler

Özel durumlar

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

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

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
//
Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)

            Dim ue As UnicodeEncoding = New UnicodeEncoding()
            Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))
            For Each c As Char In charsToAdd
                Await writer.WriteAsync(c)
            Next
            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' 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.

Şunlara uygulanır

WriteAsync(String)

Kaynak:
StringWriter.cs
Kaynak:
StringWriter.cs
Kaynak:
StringWriter.cs

Geçerli dizeye 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

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

Döndürülenler

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

Öznitelikler

Özel durumlar

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

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

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
//
Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)
            Await writer.WriteAsync("and add characters through StringWriter")
            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' 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.

Şunlara uygulanır

WriteAsync(ReadOnlyMemory<Char>, CancellationToken)

Kaynak:
StringWriter.cs
Kaynak:
StringWriter.cs
Kaynak:
StringWriter.cs

Dizeye karakterlerin bellek bölgesini zaman uyumsuz olarak 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>

Dizeye 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(StringBuilder, CancellationToken)

Kaynak:
StringWriter.cs
Kaynak:
StringWriter.cs
Kaynak:
StringWriter.cs

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

public override System.Threading.Tasks.Task WriteAsync (System.Text.StringBuilder? value, System.Threading.CancellationToken cancellationToken = default);
override this.WriteAsync : System.Text.StringBuilder * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function WriteAsync (value As StringBuilder, Optional cancellationToken As CancellationToken = Nothing) As Task

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

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.

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.

Şunlara uygulanır

WriteAsync(Char[], Int32, Int32)

Kaynak:
StringWriter.cs
Kaynak:
StringWriter.cs
Kaynak:
StringWriter.cs

Dizeye zaman uyumsuz olarak karakter alt dizisini 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[]

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

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.

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

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

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
//
Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        WriteCharacters()
    End Sub

    Async Sub WriteCharacters()
        Dim stringToWrite As StringBuilder = New StringBuilder("Characters in StringBuilder")
        stringToWrite.AppendLine()

        Using writer As StringWriter = New StringWriter(stringToWrite)

            Dim ue As UnicodeEncoding = New UnicodeEncoding()
            Dim charsToAdd() = ue.GetChars(ue.GetBytes("and chars to add"))

            Await writer.WriteAsync(charsToAdd, 0, charsToAdd.Length)

            Console.WriteLine(stringToWrite.ToString())
        End Using
    End Sub
End Module
' 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.

Şunlara uygulanır