Stream.Write Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| Write(ReadOnlySpan<Byte>) |
Quando for substituído em uma classe derivada, grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo até o número de bytes gravados. |
| Write(Byte[], Int32, Int32) |
Quando for substituído em uma classe derivada, grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo até o número de bytes gravados. |
Write(ReadOnlySpan<Byte>)
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
Quando for substituído em uma classe derivada, grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo até o número de bytes gravados.
public:
virtual void Write(ReadOnlySpan<System::Byte> buffer);public virtual void Write (ReadOnlySpan<byte> buffer);abstract member Write : ReadOnlySpan<byte> -> unit
override this.Write : ReadOnlySpan<byte> -> unitPublic Overridable Sub Write (buffer As ReadOnlySpan(Of Byte))Parâmetros
- buffer
- ReadOnlySpan<Byte>
Uma região da memória. Esse método copia o conteúdo desta região para o fluxo atual.
Comentários
Use a CanWrite propriedade para determinar se a instância atual dá suporte à gravação. Use o WriteAsync método para gravar de forma assíncrona no fluxo atual.
Se a operação de gravação for bem-sucedida, a posição dentro do fluxo avançará pelo número de bytes gravados. Se ocorrer uma exceção, a posição dentro do fluxo permanecerá inalterada.
Aplica-se a
Write(Byte[], Int32, Int32)
- Origem:
- Stream.cs
- Origem:
- Stream.cs
- Origem:
- Stream.cs
Quando for substituído em uma classe derivada, grava uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo até o número de bytes gravados.
public:
abstract void Write(cli::array <System::Byte> ^ buffer, int offset, int count);public abstract void Write (byte[] buffer, int offset, int count);abstract member Write : byte[] * int * int -> unitPublic MustOverride Sub Write (buffer As Byte(), offset As Integer, count As Integer)Parâmetros
- buffer
- Byte[]
Uma matriz de bytes. Esse método copia count bytes do buffer para o fluxo atual.
- offset
- Int32
O deslocamento de bytes baseado em zero em buffer no qual será iniciada a cópia de bytes no fluxo atual.
- count
- Int32
O número de bytes a serem gravados no fluxo atual.
Exceções
A soma de offset e count é maior que o comprimento do buffer.
buffer é null.
offset ou count é negativo.
Ocorreu um erro de E/S, como não ser possível encontrar o arquivo especificado.
Não há suporte para gravação no fluxo.
Write(Byte[], Int32, Int32) foi chamado depois que o fluxo foi fechado.
Comentários
Use a CanWrite propriedade para determinar se a instância atual dá suporte à gravação. Use o WriteAsync método para gravar de forma assíncrona no fluxo atual.
Se a operação de gravação for bem-sucedida, a posição dentro do fluxo avançará pelo número de bytes gravados. Se ocorrer uma exceção, a posição dentro do fluxo permanecerá inalterada.
