StreamWriter.Write Método

Definição

Escreve dados no fluxo.

Sobrecargas

Name Description
Write(Char)

Escreve uma personagem no stream.

Write(Char[])

Escreve um array de caracteres no stream.

Write(ReadOnlySpan<Char>)

Escreve um intervalo de caracteres para o stream.

Write(String)

Escreve uma corda no stream.

Write(Char[], Int32, Int32)

Escreve um subarray de caracteres no stream.

Write(Char)

Escreve uma personagem no stream.

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

A personagem a escrever para o stream.

Exceções

Ocorre um erro de E/S.

AutoFlush é verdadeiro ou o StreamWriter buffer está cheio, e o escritor atual está encerrado.

AutoFlush é verdadeiro ou o StreamWriter buffer está cheio, e o conteúdo do buffer não pode ser escrito no fluxo subjacente de tamanho fixo porque o StreamWriter está no final do fluxo.

Observações

Este método substitui o TextWriter.Write.

O carácter especificado é escrito no fluxo subjacente, a menos que o fim do fluxo seja atingido prematuramente. Se AutoFlush for true, Flush é invocado automaticamente.

Para uma lista de tarefas comuns de E/S, consulte Tarefas Comuns de E/S.

Ver também

Aplica-se a

Write(Char[])

Escreve um array de caracteres no stream.

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[]

Um array de caracteres contendo os dados a escrever. Se buffer for null, nada está escrito.

Exceções

Ocorre um erro de E/S.

AutoFlush é verdadeiro ou o StreamWriter buffer está cheio, e o escritor atual está encerrado.

AutoFlush é verdadeiro ou o StreamWriter buffer está cheio, e o conteúdo do buffer não pode ser escrito no fluxo subjacente de tamanho fixo porque o StreamWriter está no final do fluxo.

Observações

Este método substitui o TextWriter.Write.

Os caracteres especificados são escritos no fluxo subjacente, a menos que o fim do fluxo seja atingido prematuramente. Se AutoFlush for true, Flush é invocado automaticamente.

Este método pode proporcionar um desempenho mais rápido do que Write (char[],``int,``int) porque tem menos argumentos para verificar.

Para uma lista de tarefas comuns de E/S, consulte Tarefas Comuns de E/S.

Ver também

Aplica-se a

Write(ReadOnlySpan<Char>)

Escreve um intervalo de caracteres para o stream.

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>

A extensão das personagens para a escrita.

Aplica-se a

Write(String)

Escreve uma corda no stream.

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 para escrever no fluxo. Se value for nulo, nada é escrito.

Exceções

AutoFlush é verdadeiro ou o StreamWriter buffer está cheio, e o escritor atual está encerrado.

AutoFlush é verdadeiro ou o StreamWriter buffer está cheio, e o conteúdo do buffer não pode ser escrito no fluxo subjacente de tamanho fixo porque o StreamWriter está no final do fluxo.

Ocorre um erro de E/S.

Observações

Este método substitui o TextWriter.Write.

O especificado String é escrito no fluxo subjacente, a menos que o fim do fluxo seja atingido prematuramente.

Flush é invocado automaticamente se AutoFlush for true. Se value for null, não são escritas entradas.

Para uma lista de tarefas comuns de E/S, consulte Tarefas Comuns de E/S.

Ver também

Aplica-se a

Write(Char[], Int32, Int32)

Escreve um subarray de caracteres no stream.

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[]

Um array de caracteres que contém os dados a escrever.

index
Int32

A posição do carácter no buffer onde começar a ler dados.

count
Int32

O número máximo de caracteres para escrever.

Exceções

buffer é null.

O comprimento do buffer menos index é menor que count.

index ou count é negativo.

Ocorre um erro de E/S.

AutoFlush é verdadeiro ou o StreamWriter buffer está cheio, e o escritor atual está encerrado.

AutoFlush é verdadeiro ou o StreamWriter buffer está cheio, e o conteúdo do buffer não pode ser escrito no fluxo subjacente de tamanho fixo porque o StreamWriter está no final do fluxo.

Exemplos

Este exemplo escreve oito caracteres a partir de um array de 13 elementos para um ficheiro, começando no terceiro elemento do array.

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

Observações

Este método substitui o TextWriter.Write.

Os caracteres são lidos desde buffer o início em index e continuando até index + (count - 1). Todos os caracteres são escritos no fluxo subjacente, a menos que o fim do fluxo subjacente seja alcançado prematuramente. Flush é invocado automaticamente se AutoFlush for true.

Para uma lista de tarefas comuns de E/S, consulte Tarefas Comuns de E/S.

Ver também

Aplica-se a