StreamWriter.Write Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Grava dados no fluxo.

Sobrecargas

Write(String, Object, Object, Object)	Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que o método Format(String, Object, Object, Object).
Write(String, Object, Object)	Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que o método Format(String, Object, Object).
Write(Char[], Int32, Int32)	Grava uma subarray de caracteres no fluxo.
Write(String, Object[])	Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que o método Format(String, Object[]).
Write(ReadOnlySpan<Char>)	Grava um intervalo de caracteres no fluxo.
Write(String)	Grava uma cadeia de caracteres no fluxo.
Write(Char[])	Grava uma matriz de caracteres no fluxo.
Write(Char)	Grava um caractere no fluxo.
Write(String, Object)	Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que o método Format(String, Object).

Write(String, Object, Object, Object)

Origem:

StreamWriter.cs

Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que o método Format(String, Object, Object, Object).

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public override void Write (string format, object? arg0, object? arg1, object? arg2);

override this.Write : string * obj * obj * obj -> unit

Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

Parâmetros

format

String

Uma cadeia de caracteres de formato composto.

arg0

Object

O primeiro objeto a ser formatado e gravado.

arg1

Object

O segundo objeto a ser formatado e gravado.

arg2

Object

O terceiro objeto a ser formatado e gravado.

Comentários

Consulte Write(String, Object, Object, Object) para obter uma descrição dos recursos de formatação composta oferecidos.

Write(String, Object, Object)

Origem:

StreamWriter.cs

Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que o método Format(String, Object, Object).

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public override void Write (string format, object? arg0, object? arg1);

override this.Write : string * obj * obj -> unit

Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object)

Parâmetros

format

String

Uma cadeia de caracteres de formato composto.

arg0

Object

O primeiro objeto a ser formatado e gravado.

arg1

Object

O segundo objeto a ser formatado e gravado.

Comentários

Consulte Write(String, Object, Object) para obter uma descrição dos recursos de formatação composta oferecidos.

Write(Char[], Int32, Int32)

Origem:

StreamWriter.cs

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

ArgumentNullException

buffer é null.

ArgumentException

O comprimento do buffer menos index é menor que count.

ArgumentOutOfRangeException

index ou count é negativo.

IOException

Ocorre um erro de E/S.

ObjectDisposedException

AutoFlush é verdadeiro ou o buffer de StreamWriter está cheio e o gravador atual está fechado.

NotSupportedException

AutoFlush é verdadeiro ou o buffer de StreamWriter está cheio e o conteúdo do buffer não pode ser gravado no fluxo de tamanho fixo subjacente porque o StreamWriter está 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 namespace System;
using namespace System::IO;

int main()
{
   FileStream^ sb = gcnew FileStream( "MyFile.txt",FileMode::OpenOrCreate );
   array<Char>^b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
   StreamWriter^ sw = gcnew StreamWriter( sb );
   sw->Write( b, 3, 8 );
   sw->Close();
}

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

Esse método substitui TextWriter.Write.

Os caracteres são lidos de buffer começando em index e continuando por 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

• de E/S de Fluxo e Arquivo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo

Write(String, Object[])

Origem:

StreamWriter.cs

Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que o método Format(String, Object[]).

public:
 override void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public override void Write (string format, params object?[] arg);

override this.Write : string * obj[] -> unit

Public Overrides Sub Write (format As String, ParamArray arg As Object())

Parâmetros

format

String

Uma cadeia de caracteres de formato composto.

arg

Object[]

Uma matriz de objetos que contém zero ou mais objetos para formatar e gravar.

Comentários

Consulte Write(String, Object[]) para obter uma descrição dos recursos de formatação composta oferecidos.

Write(ReadOnlySpan<Char>)

Origem:

StreamWriter.cs

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.

Write(String)

Origem:

StreamWriter.cs

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

ObjectDisposedException

AutoFlush é verdadeiro ou o buffer de StreamWriter está cheio e o gravador atual está fechado.

NotSupportedException

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

IOException

Ocorre um erro de E/S.

Comentários

Esse método substitui TextWriter.Write.

O String especificado é 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

• de E/S de Fluxo e Arquivo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo

Write(Char[])

Origem:

StreamWriter.cs

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 será escrito.

Exceções

IOException

Ocorre um erro de E/S.

ObjectDisposedException

AutoFlush é verdadeiro ou o buffer de StreamWriter está cheio e o gravador atual está fechado.

NotSupportedException

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

Comentários

Esse 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

• de E/S de Fluxo e Arquivo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo

Write(Char)

Origem:

StreamWriter.cs

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

IOException

Ocorre um erro de E/S.

ObjectDisposedException

AutoFlush é verdadeiro ou o buffer de StreamWriter está cheio e o gravador atual está fechado.

NotSupportedException

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

Comentários

Esse 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

• de E/S de Fluxo e Arquivo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo

Write(String, Object)

Origem:

StreamWriter.cs

Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que o método Format(String, Object).

public:
 override void Write(System::String ^ format, System::Object ^ arg0);

public override void Write (string format, object? arg0);

override this.Write : string * obj -> unit

Public Overrides Sub Write (format As String, arg0 As Object)

Parâmetros

format

String

Uma cadeia de caracteres de formato composto.

arg0

Object

O objeto a ser formatado e gravado.

Comentários

Consulte Write(String, Object) para obter uma descrição dos recursos de formatação composta oferecidos.