StringWriter.Write Método

Definição

Grava dados na cadeia de caracteres.Writes data to the string.

Sobrecargas

Write(Char[], Int32, Int32)

Grava uma submatriz de caracteres na cadeia de caracteres.Writes a subarray of characters to the string.

Write(String)

Grava uma cadeia de caracteres na cadeia de caracteres atual.Writes a string to the current string.

Write(StringBuilder)

Grava a representação da cadeia de caracteres de um construtor de cadeia de caracteres na cadeia de caracteres atual.Writes the string representation of a string builder to the current string.

Write(Char)

Grava um caractere na cadeia de caracteres.Writes a character to the string.

Write(ReadOnlySpan<Char>)

Grava a representação da cadeia de caracteres de um intervalo de chars na cadeia de caracteres atual.Writes the string representation of a span of chars to the current string.

Write(Char[], Int32, Int32)

Grava uma submatriz de caracteres na cadeia de caracteres.Writes a subarray of characters to the string.

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.The character array to write data from.

index
Int32

A posição no buffer em que a leitura de dados é iniciada.The position in the buffer at which to start reading data.

count
Int32

O número máximo de caracteres a serem gravados.The maximum number of characters to write.

Exceções

buffer é null.buffer is null.

index ou count é negativo.index or count is negative.

(index + count)> buffer.(index + count)> buffer. Length.Length.

O gravador está fechado.The writer is closed.

Exemplos

Este exemplo de código é parte de um exemplo maior fornecido para o StringWriter() Construtor.This code example is part of a larger example provided for the StringWriter() constructor.

// 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.This method overrides TextWriter.Write.

Esse método grava count caracteres de dados a StringWriter partir de buffer , começando na posição index .This method writes count characters of data to this StringWriter from buffer, starting at position index.

A tabela a seguir lista exemplos de outras tarefas de e/s típicas ou relacionadas.The following table lists examples of other typical or related I/O tasks.

Para fazer isso...To do this... Veja o exemplo neste tópico...See the example in this topic...
Crie um arquivo de texto.Create a text file. Como gravar texto em um arquivoHow to: Write Text to a File
Gravar em um arquivo de texto.Write to a text file. Como gravar texto em um arquivoHow to: Write Text to a File
Ler de um arquivo de texto.Read from a text file. Como ler texto de um arquivoHow to: Read Text from a File
Acrescentar texto a um arquivo.Append text to a file. Como abrir e acrescentar a um arquivo de logHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
Obter o tamanho de um arquivo.Get the size of a file. FileInfo.Length
Obter os atributos de um arquivo.Get the attributes of a file. File.GetAttributes
Defina os atributos de um arquivo.Set the attributes of a file. File.SetAttributes
Determine se um arquivo existe.Determine if a file exists. File.Exists
Ler de um arquivo binário.Read from a binary file. Como ler e gravar em um arquivo de dados recém-criadoHow to: Read and Write to a Newly Created Data File
Gravar em um arquivo binário.Write to a binary file. Como: Ler e gravar em um arquivo de dados recém-criadoHow to: Read and Write to a Newly Created Data File

Aplica-se a

Write(String)

Grava uma cadeia de caracteres na cadeia de caracteres atual.Writes a string to the current string.

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.The string to write.

Exceções

O gravador está fechado.The writer is closed.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a StringWriter classe.This code example is part of a larger example provided for the StringWriter class.

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}
convertedCharacter = Convert.ToChar(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.This method overrides TextWriter.Write.

Se a cadeia de caracteres especificada for null , nada será gravado.If the specified string is null, nothing is written.

A tabela a seguir lista exemplos de outras tarefas de e/s típicas ou relacionadas.The following table lists examples of other typical or related I/O tasks.

Para fazer isso...To do this... Veja o exemplo neste tópico...See the example in this topic...
Crie um arquivo de texto.Create a text file. Como gravar texto em um arquivoHow to: Write Text to a File
Gravar em um arquivo de texto.Write to a text file. Como gravar texto em um arquivoHow to: Write Text to a File
Ler de um arquivo de texto.Read from a text file. Como ler texto de um arquivoHow to: Read Text from a File
Acrescentar texto a um arquivo.Append text to a file. Como abrir e acrescentar a um arquivo de logHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
Obter o tamanho de um arquivo.Get the size of a file. FileInfo.Length
Obter os atributos de um arquivo.Get the attributes of a file. File.GetAttributes
Defina os atributos de um arquivo.Set the attributes of a file. File.SetAttributes
Determine se um arquivo existe.Determine if a file exists. File.Exists
Ler de um arquivo binário.Read from a binary file. Como ler e gravar em um arquivo de dados recém-criadoHow to: Read and Write to a Newly Created Data File
Gravar em um arquivo binário.Write to a binary file. Como: Ler e gravar em um arquivo de dados recém-criadoHow to: Read and Write to a Newly Created Data File

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.Writes the string representation of a string builder to the current string.

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.The string builder to write to the string.

Aplica-se a

Write(Char)

Grava um caractere na cadeia de caracteres.Writes a character to the string.

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.The character to write.

Exceções

O gravador está fechado.The writer is closed.

Exemplos

Este exemplo de código é parte de um exemplo maior fornecido para o StringWriter() Construtor.This code example is part of a larger example provided for the StringWriter() constructor.

// 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.This method overrides TextWriter.Write.

A tabela a seguir lista exemplos de outras tarefas de e/s típicas ou relacionadas.The following table lists examples of other typical or related I/O tasks.

Para fazer isso...To do this... Veja o exemplo neste tópico...See the example in this topic...
Crie um arquivo de texto.Create a text file. Como gravar texto em um arquivoHow to: Write Text to a File
Gravar em um arquivo de texto.Write to a text file. Como gravar texto em um arquivoHow to: Write Text to a File
Ler de um arquivo de texto.Read from a text file. Como ler texto de um arquivoHow to: Read Text from a File
Acrescentar texto a um arquivo.Append text to a file. Como abrir e acrescentar a um arquivo de logHow to: Open and Append to a Log File

File.AppendText

FileInfo.AppendText
Obter o tamanho de um arquivo.Get the size of a file. FileInfo.Length
Obter os atributos de um arquivo.Get the attributes of a file. File.GetAttributes
Defina os atributos de um arquivo.Set the attributes of a file. File.SetAttributes
Determine se um arquivo existe.Determine if a file exists. File.Exists
Ler de um arquivo binário.Read from a binary file. Como ler e gravar em um arquivo de dados recém-criadoHow to: Read and Write to a Newly Created Data File
Gravar em um arquivo binário.Write to a binary file. Como: Ler e gravar em um arquivo de dados recém-criadoHow to: Read and Write to a Newly Created Data File

Aplica-se a

Write(ReadOnlySpan<Char>)

Grava a representação da cadeia de caracteres de um intervalo de chars na cadeia de caracteres atual.Writes the string representation of a span of chars to the current string.

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.A span of chars to write to the string.

Aplica-se a