StreamWriter.Write Método

Definição

Namespace:: System.IO

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assemblies:: mscorlib.dll, System.IO.dll

Assembly:: System.IO.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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(String, Object, Object, Object)	Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que o Format(String, Object, Object, Object) método.
Write(String, Object, Object)	Grava uma cadeia de caracteres formatada no fluxo usando a mesma semântica que o Format(String, Object, Object) método.
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 Format(String, Object[]) método.
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 Format(String, Object) método.

Write(String, Object, Object, Object)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

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) uma descrição das funcionalidades de formatação composta oferecidas.

Aplica-se a

Write(String, Object, Object)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

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) uma descrição das funcionalidades de formatação composta oferecidas.

Aplica-se a

Write(Char[], Int32, Int32)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

ArgumentNullException

buffer é null.

ArgumentException

O tamanho do buffer menos index é menor que count.

ArgumentOutOfRangeException

index ou count é negativo.

IOException

Ocorre um erro de E/S.

ObjectDisposedException

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

NotSupportedException

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

Write(String, ReadOnlySpan<Object>)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

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[]) uma descrição das funcionalidades de formatação composta oferecidas.

Aplica-se a

Write(ReadOnlySpan<Char>)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

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

ObjectDisposedException

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

NotSupportedException

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.

IOException

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

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

Exceções

IOException

Ocorre um erro de E/S.

ObjectDisposedException

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

NotSupportedException

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(Char)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

IOException

Ocorre um erro de E/S.

ObjectDisposedException

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

NotSupportedException

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(String, Object)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

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) uma descrição das funcionalidades de formatação composta oferecidas.

Aplica-se a

Comentários

Esta página foi útil?