StreamWriter.Write Método

Definição

Espaço de Nomes:: System.IO

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Runtime.Extensions.dll

Assemblagens:: mscorlib.dll, System.IO.dll

Assemblagem:: System.IO.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Escreve dados no fluxo.

Sobrecargas

Name	Description
Write(String, Object, Object, Object)	Escreve uma string formatada no fluxo, usando a mesma semântica do Format(String, Object, Object, Object) método.
Write(String, Object, Object)	Escreve uma string formatada no fluxo usando a mesma semântica do Format(String, Object, Object) método.
Write(Char[], Int32, Int32)	Escreve um subarray de caracteres no stream.
Write(String, ReadOnlySpan<Object>)	Escreve uma cadeia formatada no fluxo, usando a mesma semântica que Format(String, ReadOnlySpan<Object>).
Write(String, Object[])	Escreve uma string formatada no fluxo, usando a mesma semântica do Format(String, Object[]) método.
Write(ReadOnlySpan<Char>)	Escreve um intervalo de caracteres para o stream.
Write(String)	Escreve uma corda no stream.
Write(Char[])	Escreve um array de caracteres no stream.
Write(Char)	Escreve uma personagem no stream.
Write(String, Object)	Escreve uma string formatada no fluxo, usando a mesma semântica do 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

Escreve uma string formatada no fluxo, usando a mesma semântica do 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 formato composto.

arg0: Object

O primeiro objeto a formatar e a escrever.

arg1: Object

O segundo objeto: formatar e escrever.

arg2: Object

O terceiro objetivo é formatar e escrever.

Observações

Consulte Write(String, Object, Object, Object) uma descrição das capacidades 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

Escreve uma string formatada no fluxo usando a mesma semântica do 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 formato composto.

arg0: Object

O primeiro objeto a formatar e a escrever.

arg1: Object

O segundo objeto: formatar e escrever.

Observações

Consulte Write(String, Object, Object) uma descrição das capacidades 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

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

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 StreamWriter buffer está cheio, e o escritor atual está encerrado.

NotSupportedException

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

Write(String, ReadOnlySpan<Object>)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Escreve uma cadeia 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 formato composto.

arg: ReadOnlySpan<Object>

Um espaço de objetos que contém zero ou mais objetos para formatar e escrever.

Aplica-se a

Write(String, Object[])

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Escreve uma string formatada no fluxo, usando a mesma semântica do 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 formato composto.

arg: Object[]

Um array de objetos que contém zero ou mais objetos para formatar e escrever.

Observações

Consulte Write(String, Object[]) uma descrição das capacidades 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

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)

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Escreve uma corda no stream.

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

Exceções

ObjectDisposedException

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

NotSupportedException

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.

IOException

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

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Escreve um array de caracteres no stream.

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

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

Exceções

IOException

Ocorre um erro de E/S.

ObjectDisposedException

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

NotSupportedException

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

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

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

IOException

Ocorre um erro de E/S.

ObjectDisposedException

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

NotSupportedException

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

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Origem:: StreamWriter.cs

Escreve uma string formatada no fluxo, usando a mesma semântica do 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 formato composto.

arg0: Object

O objetivo de formatar e escrever.

Observações

Consulte Write(String, Object) uma descrição das capacidades de formatação composta oferecidas.

Aplica-se a

Comentários

Esta página foi útil?