StreamWriter.Write Método

Definição

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.

Confira também

Aplica-se a