Compartilhar via


IsolatedStorageFileStream.BeginWrite Método

Definição

Começa uma gravação assíncrona.

public:
 override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ array, int offset, int numBytes, AsyncCallback ^ userCallback, System::Object ^ stateObject);
public:
 override IAsyncResult ^ BeginWrite(cli::array <System::Byte> ^ buffer, int offset, int numBytes, AsyncCallback ^ userCallback, System::Object ^ stateObject);
public override IAsyncResult BeginWrite (byte[] array, int offset, int numBytes, AsyncCallback? userCallback, object? stateObject);
public override IAsyncResult BeginWrite (byte[] buffer, int offset, int numBytes, AsyncCallback userCallback, object stateObject);
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
override this.BeginWrite : byte[] * int * int * AsyncCallback * obj -> IAsyncResult
Public Overrides Function BeginWrite (array As Byte(), offset As Integer, numBytes As Integer, userCallback As AsyncCallback, stateObject As Object) As IAsyncResult
Public Overrides Function BeginWrite (buffer As Byte(), offset As Integer, numBytes As Integer, userCallback As AsyncCallback, stateObject As Object) As IAsyncResult

Parâmetros

bufferarray
Byte[]

O buffer no qual gravar dados.

offset
Int32

O deslocamento de bytes em buffer no qual será iniciada a gravação.

numBytes
Int32

O número máximo de bytes a serem gravados.

userCallback
AsyncCallback

O método a ser chamado quando a operação de gravação assíncrona é concluída. Esse parâmetro é opcional.

stateObject
Object

O status da gravação assíncrona.

Retornos

Um IAsyncResult que representa a gravação assíncrona, que possivelmente ainda está pendente. Esse IAsyncResult deve ser passado para o método EndWrite(IAsyncResult) desse fluxo para garantir que a gravação seja concluída, então libera recursos adequadamente. Isso pode ser feito pelo mesmo código que chamou um BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) ou em um retorno de chamada transmitido para BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object).

Exceções

Houve uma tentativa de gravação assíncrona além do fim do arquivo.

Comentários

Se um IsolatedStorageFileStream objeto for gravável, gravar no final do fluxo expandirá o fluxo.

A posição atual no fluxo é atualizada quando você emite a leitura ou gravação assíncrona, não quando a operação de E/S é concluída.

Você deve chamar EndWrite com o IAsyncResult objeto que esse método retorna para descobrir quantos bytes foram gravados.

Aplica-se a