FileStream.WriteAsync Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Aşırı Yüklemeler

Name	Description
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Zaman uyumsuz olarak geçerli akışa bir bayt dizisi yazar, bu akıştaki geçerli konumu yazılan bayt sayısına göre ilerletir ve iptal isteklerini izler.
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Bellek bölgesinden geçerli dosya akışına zaman uyumsuz olarak bir bayt dizisi yazar, bu dosya akışındaki geçerli konumu yazılan bayt sayısına göre ilerletir ve iptal isteklerini izler.

WriteAsync(Byte[], Int32, Int32, CancellationToken)

Kaynak:

FileStream.cs

Zaman uyumsuz olarak geçerli akışa bir bayt dizisi yazar, bu akıştaki geçerli konumu yazılan bayt sayısına göre ilerletir ve iptal isteklerini izler.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task

Parametreler

buffer

Byte[]

Veri yazacak arabellek.

offset

Int32

Baytların akışa kopyalanmasının başlayacağı sıfır tabanlı bayt uzaklığı buffer .

count

Int32

Yazacak bayt sayısı üst sınırı.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç.

Döndürülenler

Task

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

Özel durumlar

ArgumentNullException

buffer, null'e eşittir.

ArgumentOutOfRangeException

offset veya count negatiftir.

ArgumentException

ve'nin offsetcount toplamı arabellek uzunluğundan daha büyüktür.

NotSupportedException

Akış yazmayı desteklemiyor.

ObjectDisposedException

Akış atıldı.

InvalidOperationException

Akış şu anda önceki bir yazma işlemi tarafından kullanılıyor.

OperationCanceledException

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

Örnekler

Aşağıdaki örnekte, bir dosyaya zaman uyumsuz olarak yazma işlemi gösterilmektedir.

using System;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.IO;

namespace WpfApplication1
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private async void Button_Click(object sender, RoutedEventArgs e)
        {
            UnicodeEncoding uniencoding = new UnicodeEncoding();
            string filename = @"c:\Users\exampleuser\Documents\userinputlog.txt";

            byte[] result = uniencoding.GetBytes(UserInput.Text);

            using (FileStream SourceStream = File.Open(filename, FileMode.OpenOrCreate))
            {
                SourceStream.Seek(0, SeekOrigin.End);
                await SourceStream.WriteAsync(result, 0, result.Length);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Class MainWindow
    Private Async Sub Button_Click(sender As Object, e As RoutedEventArgs)
        Dim uniencoding As UnicodeEncoding = New UnicodeEncoding()
        Dim filename As String = "c:\Users\exampleuser\Documents\userinputlog.txt"

        Dim result As Byte() = uniencoding.GetBytes(UserInput.Text)

        Using SourceStream As FileStream = File.Open(filename, FileMode.OpenOrCreate)
            SourceStream.Seek(0, SeekOrigin.End)
            Await SourceStream.WriteAsync(result, 0, result.Length)
        End Using
    End Sub
End Class

Açıklamalar

yöntemi, WriteAsync ana iş parçacığını engellemeden yoğun kaynak gerektiren dosya işlemleri gerçekleştirmenizi sağlar. Bu performans değerlendirmesi, zaman alan bir akış işleminin kullanıcı arabirimi iş parçacığını engelleyip uygulamanızın çalışmıyor gibi görünmesini sağlayabildiği uygulamalarda özellikle önemlidir.

CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini kullanın.

İşlem tamamlanmadan önce iptal edilirse, döndürülen görev özelliğin CanceledStatus değerini içerir. Dosyanın tanıtıcısı atılırsa, döndürülen görev özelliğinde Exception özel durumu içerirObjectDisposedException.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Write(Byte[], Int32, Int32)oluşan özel durumlara bakın.

Ayrıca bkz.

• İptal

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Kaynak:

FileStream.cs

Bellek bölgesinden geçerli dosya akışına zaman uyumsuz olarak bir bayt dizisi yazar, bu dosya akışındaki geçerli konumu yazılan bayt sayısına göre ilerletir ve iptal isteklerini izler.

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

override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametreler

buffer

ReadOnlyMemory<Byte>

Veri yazacak bellek bölgesi.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. Varsayılan değer None değeridir.

Döndürülenler

ValueTask

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

yöntemi, WriteAsync ana iş parçacığını engellemeden yoğun kaynak kullanımlı G/Ç işlemleri gerçekleştirmenizi sağlar. Bu performans değerlendirmesi, zaman alan bir akış işleminin kullanıcı arabirimi iş parçacığını engelleyip uygulamanızın çalışmıyor gibi görünmesini sağlayabildiği uygulamalarda özellikle önemlidir.

CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini kullanın.

İşlem tamamlanmadan önce iptal edilirse, döndürülen görev özelliğin TaskStatus.CanceledTask.Status değerini içerir.