Stream.Write Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Description |
|---|---|
| Write(ReadOnlySpan<Byte>) |
Quando sobreposto numa classe derivada, escreve uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo pelo número de bytes escritos. |
| Write(Byte[], Int32, Int32) |
Quando sobreposto numa classe derivada, escreve uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo pelo número de bytes escritos. |
Write(ReadOnlySpan<Byte>)
Quando sobreposto numa classe derivada, escreve uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo pelo número de bytes escritos.
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. Este método copia o conteúdo desta região para o fluxo atual.
Observações
Use a CanWrite propriedade para determinar se a instância atual suporta escrita. Use o WriteAsync método para escrever assíncronamente no fluxo atual.
Se a operação de escrita for bem-sucedida, a posição dentro do fluxo avança pelo número de bytes escritos. Se ocorrer uma exceção, a posição dentro do fluxo mantém-se inalterada.
Aplica-se a
Write(Byte[], Int32, Int32)
Quando sobreposto numa classe derivada, escreve uma sequência de bytes no fluxo atual e avança a posição atual dentro desse fluxo pelo número de bytes escritos.
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[]
Um conjunto de bytes. Este método copia count bytes de buffer para o fluxo atual.
- offset
- Int32
O deslocamento de bytes baseado em zero em buffer que se deve começar a copiar bytes para o fluxo atual.
- count
- Int32
O número de bytes a escrever no fluxo atual.
Exceções
A soma de offset e count é maior do que o comprimento do tampão.
buffer é null.
offset ou count é negativo.
Ocorreu um erro de E/S, por exemplo, o ficheiro especificado não ter sido encontrado.
O stream não suporta escrita.
Write(Byte[], Int32, Int32) foi chamado depois do encerramento do riacho.
Observações
Use a CanWrite propriedade para determinar se a instância atual suporta escrita. Use o WriteAsync método para escrever assíncronamente no fluxo atual.
Se a operação de escrita for bem-sucedida, a posição dentro do fluxo avança pelo número de bytes escritos. Se ocorrer uma exceção, a posição dentro do fluxo mantém-se inalterada.