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

Definição

Sobrecargas

Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>) Write(ReadOnlySpan<Byte>)
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>)

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>

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 é parte de um exemplo maior fornecido para o Lock 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 do buffer) no qual será iniciada a cópia 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, avança a posição atual do fluxo 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 está inalterada.If an exception occurs, the current position of the stream is unchanged.

Observação

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. Para obter mais informações, consulte: CanWrite.For additional information, see CanWrite.

Interrompe um thread que está executando uma operação de gravação.Do not interrupt a thread that is performing a write operation. Embora o aplicativo possa aparecer ser executado com êxito depois que o thread será 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 diretório e arquivos 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