StringWriter.Write Método

Referência

Definição

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.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 na cadeia de caracteres.

Sobrecargas

Write(Char[], Int32, Int32)	Grava uma submatriz de caracteres na cadeia de caracteres.
Write(String)	Grava uma cadeia de caracteres na cadeia de caracteres atual.
Write(StringBuilder)	Grava a representação da cadeia de caracteres de um construtor de cadeia de caracteres na cadeia de caracteres atual.
Write(Char)	Grava um caractere na cadeia de caracteres.
Write(ReadOnlySpan<Char>)	Grava a representação da cadeia de caracteres de um intervalo de chars na cadeia de caracteres atual.

Write(Char[], Int32, Int32)

Grava uma submatriz de caracteres na cadeia de caracteres.

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

A matriz de caracteres da qual os dados serão gravados.

index: Int32

A posição no buffer em que a leitura de dados é iniciada.

count: Int32

O número máximo de caracteres a serem gravados.

Exceções

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

index ou count é negativo.

ArgumentException

(index + count)> buffer. Length.

ObjectDisposedException

O gravador está fechado.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para o StringWriter() construtor.

// Use the three overloads of the Write method that are 
// overridden by the StringWriter class.
strWriter->Write( "file path characters are: " );
strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
strWriter->Write( Char::Parse( "." ) );

// Use the three overloads of the Write method that are
// overridden by the StringWriter class.
strWriter.Write("file path characters are: ");
strWriter.Write(
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);
strWriter.Write('.');

' Use the three overloads of the Write method that are 
' overridden by the StringWriter class.
strWriter.Write("file path characters are: ")
strWriter.Write( _
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)
strWriter.Write("."C)

Comentários

Este método substitui TextWriter.Write.

Esse método grava caracteres count de dados a partir disso StringWriter buffer, começando na posição index.

A tabela a seguir lista exemplos de outras tarefas de E/S típicas ou relacionadas.

Para fazer isso...	Veja o exemplo neste tópico...
Crie um arquivo de texto.	Como gravar texto em um arquivo
Gravar em um arquivo de texto.	Como gravar texto em um arquivo
Ler de um arquivo de texto.	Como ler texto de um arquivo
Acrescente texto a um arquivo.	Como abrir e acrescentar a um arquivo de log File.AppendText FileInfo.AppendText
Obtenha o tamanho de um arquivo.	FileInfo.Length
Obtenha os atributos de um arquivo.	File.GetAttributes
Defina os atributos de um arquivo.	File.SetAttributes
Determine se existe um arquivo.	File.Exists
Ler de um arquivo binário.	Como ler e gravar em um arquivo de dados recém-criado
Gravar em um arquivo binário.	Como: Ler e gravar em um arquivo de dados recém-criado

Confira também

Aplica-se a

Write(String)

Grava uma cadeia de caracteres na cadeia de caracteres atual.

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.

Exceções

ObjectDisposedException

O gravador está fechado.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a StringWriter classe.

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}

convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
    strWriter.Write(".\n\n");

    // Bypass the spaces between sentences.
    strReader.Read();
    strReader.Read();
}

convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
    strWriter.Write("." & vbCrLf & vbCrLf)

    ' Bypass the spaces between sentences.
    strReader.Read()
    strReader.Read()

Comentários

Este método substitui TextWriter.Write.

Se a cadeia de caracteres especificada for null, nada será gravado.

A tabela a seguir lista exemplos de outras tarefas de E/S típicas ou relacionadas.

Para fazer isso...	Veja o exemplo neste tópico...
Crie um arquivo de texto.	Como gravar texto em um arquivo
Gravar em um arquivo de texto.	Como gravar texto em um arquivo
Ler de um arquivo de texto.	Como ler texto de um arquivo
Acrescente texto a um arquivo.	Como abrir e acrescentar a um arquivo de log File.AppendText FileInfo.AppendText
Obtenha o tamanho de um arquivo.	FileInfo.Length
Obtenha os atributos de um arquivo.	File.GetAttributes
Defina os atributos de um arquivo.	File.SetAttributes
Determine se existe um arquivo.	File.Exists
Ler de um arquivo binário.	Como ler e gravar em um arquivo de dados recém-criado
Gravar em um arquivo binário.	Como: Ler e gravar em um arquivo de dados recém-criado

Confira também

Aplica-se a

Write(StringBuilder)

Grava a representação da cadeia de caracteres de um construtor de cadeia de caracteres na cadeia de caracteres atual.

public:
 override void Write(System::Text::StringBuilder ^ value);

public override void Write (System.Text.StringBuilder? value);

override this.Write : System.Text.StringBuilder -> unit

Public Overrides Sub Write (value As StringBuilder)

Parâmetros

value: StringBuilder

O construtor de cadeia de caracteres a ser gravado na cadeia de caracteres.

Aplica-se a

Write(Char)

Grava um caractere na cadeia de caracteres.

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 se gravar.

Exceções

ObjectDisposedException

O gravador está fechado.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para o StringWriter() construtor.

// Use the three overloads of the Write method that are 
// overridden by the StringWriter class.
strWriter->Write( "file path characters are: " );
strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
strWriter->Write( Char::Parse( "." ) );

// Use the three overloads of the Write method that are
// overridden by the StringWriter class.
strWriter.Write("file path characters are: ");
strWriter.Write(
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);
strWriter.Write('.');

' Use the three overloads of the Write method that are 
' overridden by the StringWriter class.
strWriter.Write("file path characters are: ")
strWriter.Write( _
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)
strWriter.Write("."C)

Comentários

Este método substitui TextWriter.Write.

A tabela a seguir lista exemplos de outras tarefas de E/S típicas ou relacionadas.

Para fazer isso...	Veja o exemplo neste tópico...
Crie um arquivo de texto.	Como gravar texto em um arquivo
Gravar em um arquivo de texto.	Como gravar texto em um arquivo
Ler de um arquivo de texto.	Como ler texto de um arquivo
Acrescente texto a um arquivo.	Como abrir e acrescentar a um arquivo de log File.AppendText FileInfo.AppendText
Obtenha o tamanho de um arquivo.	FileInfo.Length
Obtenha os atributos de um arquivo.	File.GetAttributes
Defina os atributos de um arquivo.	File.SetAttributes
Determine se existe um arquivo.	File.Exists
Ler de um arquivo binário.	Como ler e gravar em um arquivo de dados recém-criado
Gravar em um arquivo binário.	Como: Ler e gravar em um arquivo de dados recém-criado

Confira também

Aplica-se a

Write(ReadOnlySpan<Char>)

Grava a representação da cadeia de caracteres de um intervalo de chars na cadeia de caracteres atual.

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>

Um intervalo de chars a serem gravados na cadeia de caracteres.

Aplica-se a

StringWriter.Write Método

Definição

Sobrecargas

Write(Char[], Int32, Int32)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Write(String)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Write(StringBuilder)

Parâmetros

Aplica-se a

Write(Char)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Write(ReadOnlySpan<Char>)

Parâmetros

Aplica-se a

Recursos adicionais