Compartilhar via


StreamWriter.Write Método

Definição

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, ReadOnlySpan<Object>)

Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que Format(String, ReadOnlySpan<Object>).

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
Origem:
StreamWriter.cs
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.

Aplica-se a

Write(String, Object, Object)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
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.

Aplica-se a

Write(Char[], Int32, Int32)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
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

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 buffer de StreamWriter está cheio e o gravador atual está fechado.

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

Aplica-se a

Write(String, ReadOnlySpan<Object>)

Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que Format(String, ReadOnlySpan<Object>).

public:
 override void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public override void Write (string format, scoped ReadOnlySpan<object?> arg);
override this.Write : string * ReadOnlySpan<obj> -> unit
Public Overrides Sub Write (format As String, arg As ReadOnlySpan(Of Object))

Parâmetros

format
String

Uma cadeia de caracteres de formato composto.

arg
ReadOnlySpan<Object>

Um intervalo de objeto que contém zero ou mais objetos para formatar e gravar.

Aplica-se a

Write(String, Object[])

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
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.

Aplica-se a

Write(ReadOnlySpan<Char>)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
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.

Aplica-se a

Write(String)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Grava uma cadeia de caracteres no fluxo.

public:
 override void Write(System::String ^ value);
public override void Write (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 é verdadeiro ou o buffer de StreamWriter está cheio e o gravador atual está fechado.

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.

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

Aplica-se a

Write(Char[])

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
Origem:
StreamWriter.cs

Grava uma matriz de caracteres no fluxo.

public:
 override void Write(cli::array <char> ^ buffer);
public override void Write (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

Ocorre um erro de E/S.

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

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

Aplica-se a

Write(Char)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
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

Ocorre um erro de E/S.

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

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

Aplica-se a

Write(String, Object)

Origem:
StreamWriter.cs
Origem:
StreamWriter.cs
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.

Aplica-se a