FileStream.WriteAsync FileStream.WriteAsync FileStream.WriteAsync Method

Definição

Sobrecargas

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

Grava uma sequência de bytes no fluxo atual assincronamente, avança a posição atual dentro desse fluxo pelo número de bytes gravados e monitora as solicitações de cancelamento.Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

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

Grava uma sequência de bytes no fluxo atual assincronamente, avança a posição atual dentro desse fluxo pelo número de bytes gravados e monitora as solicitações de cancelamento.Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);
[System.Runtime.InteropServices.ComVisible(false)]
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

Parâmetros

buffer
Byte[]

O buffer do qual os dados serão gravados.The buffer to write data from.

offset
Int32 Int32 Int32

O deslocamento de bytes baseado em zero em buffer do qual será iniciada a cópia de bytes no fluxo.The zero-based byte offset in buffer from which to begin copying bytes to the stream.

count
Int32 Int32 Int32

O número máximo de bytes a serem gravados.The maximum number of bytes to write.

cancellationToken
CancellationToken CancellationToken CancellationToken

O token a se monitorar para solicitações de cancelamento.The token to monitor for cancellation requests.

Retornos

Uma tarefa que representa a operação de gravação assíncrona.A task that represents the asynchronous write operation.

Exceções

offset ou count é negativo.offset or count is negative.

A soma de offset e count é maior que o tamanho do buffer.The sum of offset and count is larger than the buffer length.

Não há suporte para gravação no fluxo.The stream does not support writing.

O fluxo foi descartado.The stream has been disposed.

O fluxo está em uso no momento por uma operação de gravação anterior.The stream is currently in use by a previous write operation.

Exemplos

O exemplo a seguir mostra como gravar em um arquivo de forma assíncrona.The following example shows how to write asynchronously to a file.

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

Comentários

O WriteAsync método permite que você execute operações de arquivo de uso intensivo de recursos sem bloquear o thread principal.The WriteAsync method enables you to perform resource-intensive file operations without blocking the main thread. Essa consideração sobre o desempenho é particularmente importante em um aplicativo Windows Store 8.xWindows 8.x Store ou área de trabalhodesktop em que uma operação demorada de fluxo pode bloquear o thread de interface do usuário e fazer seu aplicativo parecer como se não estivesse funcionando.This performance consideration is particularly important in a Windows Store 8.xWindows 8.x Store app or área de trabalhodesktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. Os métodos assíncronos são usados em conjunto com o async e await palavras-chave no Visual Basic e c#.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

Use o CanWrite propriedade para determinar se a instância atual dá suporte à gravação.Use the CanWrite property to determine whether the current instance supports writing.

Se a operação for cancelada antes de ser concluída, a tarefa retornada contém o Canceled de valor para o Status propriedade.If the operation is canceled before it completes, the returned task contains the Canceled value for the Status property. Se o identificador para o arquivo é descartado, a tarefa retornada contém o ObjectDisposedException exceção no Exception propriedade.If the handle to the file is disposed, the returned task contains the ObjectDisposedException exception in the Exception property.

Veja também

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

public override System.Threading.Tasks.ValueTask WriteAsync (ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = null);
override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Parâmetros

Retornos

Aplica-se a