StringWriter.Write Método

Definição

Espaço de Nomes:: System.IO

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

Assemblagem:: mscorlib.dll

Assemblagem:: System.IO.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 na cadeia.

Sobrecargas

Name	Description
Write(Char[], Int32, Int32)	Escreve um subarray de caracteres na cadeia.
Write(String)	Escreve uma cadeia na cadeia atual.
Write(ReadOnlySpan<Char>)	Escreve a representação da cadeia de um intervalo de caracteres na cadeia atual.
Write(Char)	Escreve um carácter na cadeia.

Write(Char[], Int32, Int32)

Escreve um subarray de caracteres na cadeia.

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

O array de caracteres para escrever dados.

index: Int32

A posição no buffer onde começar a ler dados.

count: Int32

O número máximo de caracteres para escrever.

Exceções

ArgumentNullException

buffer é null.

ArgumentOutOfRangeException

index ou count é negativo.

ArgumentException

(index + count).>buffer Length.

ObjectDisposedException

O escritor está fechado.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido ao 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('.');

' 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)

Observações

Este método substitui o TextWriter.Write.

Este método escreve count caracteres de dados para isto StringWriter a partir de buffer, começando na posição index.

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

Para fazer isso...	Veja o exemplo neste tópico...
Crie um arquivo de texto.	Como: Gravar texto em um arquivo
Escreve num ficheiro de texto.	Como: Gravar texto em um arquivo
Lido de um ficheiro de texto.	Como: Ler texto de um arquivo
Adicione texto a um ficheiro.	Como: Abrir e anexar a um arquivo de log File.AppendText FileInfo.AppendText
Obtém o tamanho de um ficheiro.	FileInfo.Length
Obtenha as características de um ficheiro.	File.GetAttributes
Defina os atributos de um ficheiro.	File.SetAttributes
Determina se existe um ficheiro.	File.Exists
Lê a partir de um ficheiro binário.	Como: Ler e gravar em um arquivo de dados recém-criado
Escreve num ficheiro binário.	Como: Ler e gravar em um arquivo de dados recém-criado

Ver também

Aplica-se a

Write(String)

Escreve uma cadeia na cadeia 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 sequência para escrever.

Exceções

ObjectDisposedException

O escritor está fechado.

Exemplos

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

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

Observações

Este método substitui o TextWriter.Write.

Se a cadeia especificada for null, nada é escrito.

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

Para fazer isso...	Veja o exemplo neste tópico...
Crie um arquivo de texto.	Como: Gravar texto em um arquivo
Escreve num ficheiro de texto.	Como: Gravar texto em um arquivo
Lido de um ficheiro de texto.	Como: Ler texto de um arquivo
Adicione texto a um ficheiro.	Como: Abrir e anexar a um arquivo de log File.AppendText FileInfo.AppendText
Obtém o tamanho de um ficheiro.	FileInfo.Length
Obtenha as características de um ficheiro.	File.GetAttributes
Defina os atributos de um ficheiro.	File.SetAttributes
Determina se existe um ficheiro.	File.Exists
Lê a partir de um ficheiro binário.	Como: Ler e gravar em um arquivo de dados recém-criado
Escreve num ficheiro binário.	Como: Ler e gravar em um arquivo de dados recém-criado

Ver também

Aplica-se a

Write(ReadOnlySpan<Char>)

Escreve a representação da cadeia de um intervalo de caracteres na cadeia 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 caracteres para escrever na cadeia.

Aplica-se a

Write(Char)

Escreve um carácter na cadeia.

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.

Exceções

ObjectDisposedException

O escritor está fechado.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido ao 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('.');

' 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)

Observações

Este método substitui o TextWriter.Write.

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

Para fazer isso...	Veja o exemplo neste tópico...
Crie um arquivo de texto.	Como: Gravar texto em um arquivo
Escreve num ficheiro de texto.	Como: Gravar texto em um arquivo
Lido de um ficheiro de texto.	Como: Ler texto de um arquivo
Adicione texto a um ficheiro.	Como: Abrir e anexar a um arquivo de log File.AppendText FileInfo.AppendText
Obtém o tamanho de um ficheiro.	FileInfo.Length
Obtenha as características de um ficheiro.	File.GetAttributes
Defina os atributos de um ficheiro.	File.SetAttributes
Determina se existe um ficheiro.	File.Exists
Lê a partir de um ficheiro binário.	Como: Ler e gravar em um arquivo de dados recém-criado
Escreve num ficheiro binário.	Como: Ler e gravar em um arquivo de dados recém-criado

Ver também

Aplica-se a

Comentários

Esta página foi útil?