FileStream.Write FileStream.Write FileStream.Write FileStream.Write Method

Definição

Sobrecargas

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)

Grava uma sequência de bytes de um intervalo somente leitura no fluxo de arquivo atual e avança a posição atual nesse fluxo de arquivo até o número de bytes gravados.Writes a sequence of bytes from a read-only span to the current file stream and advances the current position within this file stream by the number of bytes written.

Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Grava um bloco de bytes no fluxo de arquivo.Writes a block of bytes to the file stream.

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)

Grava uma sequência de bytes de um intervalo somente leitura no fluxo de arquivo atual e avança a posição atual nesse fluxo de arquivo até o número de bytes gravados.Writes a sequence of bytes from a read-only span to the current file stream and advances the current position within this file stream by the number of bytes written.

public:
 override void Write(ReadOnlySpan<System::Byte> buffer);
public override void Write (ReadOnlySpan<byte> buffer);
override this.Write : ReadOnlySpan<byte> -> unit
Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))

Parâmetros

buffer
ReadOnlySpan<Byte>

Uma região da memória.A region of memory. Esse método copia o conteúdo dessa região para o fluxo de arquivo atual.This method copies the contents of this region to the current file stream.

Comentários

Use a CanWrite propriedade para determinar se a instância atual oferece suporte à gravação.Use the CanWrite property to determine whether the current instance supports writing. Use o WriteAsync método para gravar de forma assíncrona no fluxo atual.Use the WriteAsync method to write asynchronously to the current stream.

Se a operação de gravação for bem-sucedida, a posição dentro do fluxo de arquivos avançará pelo número de bytes gravados.If the write operation is successful, the position within the file stream advances by the number of bytes written. Se ocorrer uma exceção, a posição dentro do fluxo de arquivos permanecerá inalterada.If an exception occurs, the position within the file stream remains unchanged.

Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32) Write(Byte[], Int32, Int32)

Grava um bloco de bytes no fluxo de arquivo.Writes a block of bytes to the file stream.

public:
 override void Write(cli::array <System::Byte> ^ array, int offset, int count);
public override void Write (byte[] array, int offset, int count);
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (array As Byte(), offset As Integer, count As Integer)

Parâmetros

array
Byte[]

O buffer que contém dados a serem gravados no fluxo.The buffer containing data to write to the stream.

offset
Int32 Int32 Int32 Int32

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

count
Int32 Int32 Int32 Int32

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

Exceções

offset e count descrevem um intervalo inválido em array.offset and count describe an invalid range in array.

Ocorreu um erro de E/S.An I/O error occurred.

- ou --or-

Outro thread pode ter causado uma alteração inesperada na posição do identificador de arquivo do sistema operacional.Another thread may have caused an unexpected change in the position of the operating system's file handle.

A instância de fluxo atual não dá suporte à gravação.The current stream instance does not support writing.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para Lock o método.This code example is part of a larger example provided for the Lock method.

// Write the original file data.
if ( fileStream->Length == 0 )
{
   tempString = String::Concat( lastRecordText, recordNumber.ToString() );
   fileStream->Write( uniEncoding->GetBytes( tempString ), 0, uniEncoding->GetByteCount( tempString ) );
}

// Write the original file data.
if(fileStream.Length == 0)
{
    tempString = 
        lastRecordText + recordNumber.ToString();
    fileStream.Write(uniEncoding.GetBytes(tempString), 
        0, uniEncoding.GetByteCount(tempString));
}
' Write the original file data.
If aFileStream.Length = 0 Then
    tempString = _
        lastRecordText + recordNumber.ToString()
    aFileStream.Write(uniEncoding.GetBytes(tempString), _
        0, uniEncoding.GetByteCount(tempString))
End If

Comentários

Este método substitui Write.This method overrides Write.

O offset parâmetro fornece o deslocamento do byte em array (o índice de buffer) no qual começar a copiar e o count parâmetro fornece o número de bytes que serão gravados no fluxo.The offset parameter gives the offset of the byte in array (the buffer index) at which to begin copying, and the count parameter gives the number of bytes that will be written to the stream. Se a operação de gravação for bem-sucedida, a posição atual do fluxo será avançada pelo número de bytes gravados.If the write operation is successful, the current position of the stream is advanced by the number of bytes written. Se ocorrer uma exceção, a posição atual do fluxo será inalterada.If an exception occurs, the current position of the stream is unchanged.

Observação

Use a CanWrite propriedade para determinar se a instância atual oferece suporte à gravação.Use the CanWrite property to determine whether the current instance supports writing. Para obter mais informações, consulte: CanWrite.For additional information, see CanWrite.

Não interrompa um thread que esteja executando uma operação de gravação.Do not interrupt a thread that is performing a write operation. Embora o aplicativo possa parecer ser executado com êxito depois que o thread é desbloqueado, a interrupção pode diminuir o desempenho e a confiabilidade do seu aplicativo.Although the application may appear to run successfully after the thread is unblocked, the interruption can decrease your application's performance and reliability.

Para obter uma lista de operações de arquivo e diretório comuns, consulte tarefas comuns de e/s.For a list of common file and directory operations, see Common I/O Tasks.

Veja também

Aplica-se a