StreamWriter.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.
Grava dados no fluxo.
Sobrecargas
| Nome | Description |
|---|---|
| Write(Char) |
Grava um caractere no fluxo. |
| Write(Char[]) |
Grava uma matriz de caracteres no fluxo. |
| Write(ReadOnlySpan<Char>) |
Grava um intervalo de caracteres no fluxo. |
| Write(String) |
Grava uma cadeia de caracteres no fluxo. |
| Write(Char[], Int32, Int32) |
Grava uma subarray de caracteres no fluxo. |
Write(Char)
Grava um caractere no fluxo.
public:
override void Write(char value);
public override void Write(char value);
override this.Write : char -> unit
Public Overrides Sub Write (value As Char)
Parâmetros
- value
- Char
O caractere a ser gravado no fluxo.
Exceções
Ocorre um erro de E/S.
AutoFlush é true ou o StreamWriter buffer está cheio e o gravador atual está fechado.
AutoFlush é true ou o StreamWriter buffer está cheio e o conteúdo do buffer não pode ser gravado no fluxo de tamanho fixo subjacente porque está StreamWriter no final do fluxo.
Comentários
Este método substitui TextWriter.Write.
O caractere especificado é gravado no fluxo subjacente, a menos que o final do fluxo seja atingido prematuramente. Se AutoFlush for true, Flush será invocado automaticamente.
Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.
Confira também
Aplica-se a
Write(Char[])
Grava uma matriz de caracteres no fluxo.
public:
override void Write(cli::array <char> ^ buffer);
public override void Write(char[] buffer);
override this.Write : char[] -> unit
Public Overrides Sub Write (buffer As Char())
Parâmetros
- buffer
- Char[]
Uma matriz de caracteres que contém os dados a serem gravados. Se buffer for null, nada está escrito.
Exceções
Ocorre um erro de E/S.
AutoFlush é true ou o StreamWriter buffer está cheio e o gravador atual está fechado.
AutoFlush é true ou o StreamWriter buffer está cheio e o conteúdo do buffer não pode ser gravado no fluxo de tamanho fixo subjacente porque está StreamWriter no final do fluxo.
Comentários
Este método substitui TextWriter.Write.
Os caracteres especificados são gravados no fluxo subjacente, a menos que o final do fluxo seja atingido prematuramente. Se AutoFlush for true, Flush será invocado automaticamente.
Esse método pode fornecer um desempenho mais rápido do que Write (char[],``int,``int) porque tem menos argumentos para verificar.
Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.
Confira também
Aplica-se a
Write(ReadOnlySpan<Char>)
Grava um intervalo de caracteres no fluxo.
public:
override void Write(ReadOnlySpan<char> buffer);
public override void Write(ReadOnlySpan<char> buffer);
override this.Write : ReadOnlySpan<char> -> unit
Public Overrides Sub Write (buffer As ReadOnlySpan(Of Char))
Parâmetros
- buffer
- ReadOnlySpan<Char>
O intervalo de caracteres a ser gravado.
Aplica-se a
Write(String)
Grava uma cadeia de caracteres no fluxo.
public:
override void Write(System::String ^ value);
public override void Write(string value);
override this.Write : string -> unit
Public Overrides Sub Write (value As String)
Parâmetros
- value
- String
A cadeia de caracteres a ser gravada no fluxo. Se value for nulo, nada será escrito.
Exceções
AutoFlush é true ou o StreamWriter buffer está cheio e o gravador atual está fechado.
AutoFlush é true ou o StreamWriter buffer está cheio e o conteúdo do buffer não pode ser gravado no fluxo de tamanho fixo subjacente porque está StreamWriter no final do fluxo.
Ocorre um erro de E/S.
Comentários
Este método substitui TextWriter.Write.
O especificado String é gravado no fluxo subjacente, a menos que o final do fluxo seja atingido prematuramente.
Flush será invocado automaticamente se AutoFlush for true. Se value for null, nenhuma entrada será gravada.
Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.
Confira também
Aplica-se a
Write(Char[], Int32, Int32)
Grava uma subarray de caracteres no fluxo.
public:
override void Write(cli::array <char> ^ buffer, int index, int count);
public override void Write(char[] buffer, int index, int count);
override this.Write : char[] * int * int -> unit
Public Overrides Sub Write (buffer As Char(), index As Integer, count As Integer)
Parâmetros
- buffer
- Char[]
Uma matriz de caracteres que contém os dados a serem gravados.
- index
- Int32
A posição do caractere no buffer no qual iniciar a leitura de dados.
- count
- Int32
O número máximo de caracteres a serem gravados.
Exceções
buffer é null.
O tamanho do buffer menos index é menor que count.
index ou count é negativo.
Ocorre um erro de E/S.
AutoFlush é true ou o StreamWriter buffer está cheio e o gravador atual está fechado.
AutoFlush é true ou o StreamWriter buffer está cheio e o conteúdo do buffer não pode ser gravado no fluxo de tamanho fixo subjacente porque está StreamWriter no final do fluxo.
Exemplos
Este exemplo grava oito caracteres de uma matriz de 13 elementos em um arquivo, começando no terceiro elemento da matriz.
using System;
using System.IO;
public class SWBuff
{
public static void Main(String[] args)
{
FileStream sb = new FileStream("MyFile.txt", FileMode.OpenOrCreate);
char[] b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
StreamWriter sw = new StreamWriter(sb);
sw.Write(b, 3, 8);
sw.Close();
}
}
Imports System.IO
Public Class SWBuff
Public Shared Sub Main()
Dim sb As New FileStream("MyFile.txt", FileMode.OpenOrCreate)
Dim b As Char() = {"a"c, "b"c, "c"c, "d"c, "e"c, "f"c, "g"c, _
"h"c, "i"c, "j"c, "k"c, "l"c, "m"c}
Dim sw As New StreamWriter(sb)
sw.Write(b, 3, 8)
sw.Close()
End Sub
End Class
Comentários
Este método substitui TextWriter.Write.
Os caracteres são lidos desde buffer o index início e continuam até index + (count - 1). Todos os caracteres são gravados no fluxo subjacente, a menos que o final do fluxo subjacente seja atingido prematuramente.
Flush será invocado automaticamente se AutoFlush for true.
Para obter uma lista de tarefas comuns de E/S, consulte Tarefas comuns de E/S.