StringWriter.Write Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

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)

Origem:

StringWriter.cs

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 para isso StringWriter de 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 o 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

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

Write(String)

Origem:

StringWriter.cs

Grava uma cadeia de caracteres na cadeia de caracteres atual.

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.

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 o 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

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

Write(StringBuilder)

Origem:

StringWriter.cs

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.

Write(Char)

Origem:

StringWriter.cs

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 o 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

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

Write(ReadOnlySpan<Char>)

Origem:

StringWriter.cs

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.