StringWriter Construtores

Definição

Espaço de Nomes:
System.IO
Assemblagens:
mscorlib.dll, System.IO.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.IO.dll
Assemblagem:
System.Runtime.Extensions.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Inicializa uma nova instância da StringWriter classe.

Sobrecargas

Name Description
StringWriter()

Inicializa uma nova instância da StringWriter classe.
StringWriter(IFormatProvider)

Inicializa uma nova instância da StringWriter classe com o controlo de formato especificado.
StringWriter(StringBuilder)

Inicializa uma nova instância da StringWriter classe que escreve no especificado StringBuilder.
StringWriter(StringBuilder, IFormatProvider)

Inicializa uma nova instância da StringWriter classe que escreve no especificado StringBuilder e tem o fornecedor de formato especificado.

StringWriter()

Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs

Inicializa uma nova instância da StringWriter classe.

public:
 StringWriter();
public StringWriter();
Public Sub New ()

Exemplos

O exemplo de código seguinte demonstra como construir uma string usando a StringWriter classe.

using System;
using System.IO;
using System.Text;

class StrWriter
{
    static void Main()
    {
        StringWriter strWriter  = new StringWriter();

        // 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 underlying StringBuilder for more complex
        // manipulations of the string.
        strWriter.GetStringBuilder().Insert(0, "Invalid ");

        Console.WriteLine("The following string is {0} encoded.\n{1}",
            strWriter.Encoding.EncodingName, strWriter.ToString());
    }
}

Imports System.IO
Imports System.Text

Public Class StrWriter

    Shared Sub Main()

        Dim strWriter As StringWriter = new StringWriter()

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

        ' Use the underlying StringBuilder for more complex 
        ' manipulations of the string.
        strWriter.GetStringBuilder().Insert(0, "Invalid ")

        Console.WriteLine("The following string is {0} encoded." _
            & vbCrLf & "{1}", _
            strWriter.Encoding.EncodingName, strWriter.ToString())

    End Sub
End Class

Observações

Um novo StringBuilder objeto é automaticamente criado e associado à nova instância da StringWriter classe. Como um controlo de formato não é especificado para este construtor, a nova instância será inicializada com CultureInfo.CurrentCulture.

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

StringWriter(IFormatProvider)

Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs

Inicializa uma nova instância da StringWriter classe com o controlo de formato especificado.

public:
 StringWriter(IFormatProvider ^ formatProvider);
public StringWriter(IFormatProvider formatProvider);
public StringWriter(IFormatProvider? formatProvider);
new System.IO.StringWriter : IFormatProvider -> System.IO.StringWriter
Public Sub New (formatProvider As IFormatProvider)

Parâmetros

formatProvider
IFormatProvider

Um objeto que controla a IFormatProvider formatação.

Exemplos

O exemplo de código seguinte demonstra como construir uma cadeia numa cultura específica.

using System;
using System.Globalization;
using System.IO;

class StrWriter
{
    static void Main()
    {
        StringWriter strWriter =
            new StringWriter(new CultureInfo("ar-DZ"));

        strWriter.Write(DateTime.Now);

        Console.WriteLine(
            "Current date and time using the invariant culture: {0}\n" +
            "Current date and time using the Algerian culture: {1}",
            DateTime.Now.ToString(), strWriter.ToString());
    }
}

Imports System.Globalization
Imports System.IO

Public Class StrWriter

    Shared Sub Main()
        Dim strWriter As New StringWriter(New CultureInfo("ar-DZ"))

        strWriter.Write(DateTime.Now)

        Console.WriteLine( _
            "Current date and time using the invariant culture: {0}" _
            & vbCrLf & _
            "Current date and time using the Algerian culture: {1}", _
            DateTime.Now.ToString(), strWriter.ToString())
    End Sub

End Class

Observações

Um novo StringBuilder objeto é automaticamente criado e associado à nova instância da StringWriter classe.

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

StringWriter(StringBuilder)

Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs

Inicializa uma nova instância da StringWriter classe que escreve no especificado StringBuilder.

public:
 StringWriter(System::Text::StringBuilder ^ sb);
public StringWriter(System.Text.StringBuilder sb);
new System.IO.StringWriter : System.Text.StringBuilder -> System.IO.StringWriter
Public Sub New (sb As StringBuilder)

Parâmetros

sb
StringBuilder

O StringBuilder objeto para escrever.

Exceções

ArgumentNullException

sb é null.

Exemplos

O exemplo de código seguinte demonstra o uso da StringBuilder classe para modificar a cadeia subjacente numa ficha fechada StringWriter.

using System;
using System.IO;
using System.Text;

class StrWriter
{
    static void Main()
    {
        StringBuilder strBuilder =
            new StringBuilder("file path characters are: ");
        StringWriter strWriter = new StringWriter(strBuilder);

        strWriter.Write(
            Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);

        strWriter.Close();

        // Since the StringWriter is closed, an exception will
        // be thrown if the Write method is called. However,
        // the StringBuilder can still manipulate the string.
        strBuilder.Insert(0, "Invalid ");
        Console.WriteLine(strWriter.ToString());
    }
}

Imports System.IO
Imports System.Text

Public Class StrWriter

    Shared Sub Main()
        Dim strBuilder As New StringBuilder( _
            "file path characters are: ")
        Dim strWriter As New StringWriter(strBuilder)

        strWriter.Write( _
            Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)

        strWriter.Close()

        ' Since the StringWriter is closed, an exception will 
        ' be thrown if the Write method is called. However, 
        ' the StringBuilder can still manipulate the string.
        strBuilder.Insert(0, "Invalid ")
        Console.WriteLine(strWriter.ToString())
    End Sub

End Class

Observações

Como um controlo de formato não é especificado para este construtor, a nova instância será inicializada com CultureInfo.CurrentCulture.

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

StringWriter(StringBuilder, IFormatProvider)

Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs
Origem:
StringWriter.cs

Inicializa uma nova instância da StringWriter classe que escreve no especificado StringBuilder e tem o fornecedor de formato especificado.

public:
 StringWriter(System::Text::StringBuilder ^ sb, IFormatProvider ^ formatProvider);
public StringWriter(System.Text.StringBuilder sb, IFormatProvider formatProvider);
public StringWriter(System.Text.StringBuilder sb, IFormatProvider? formatProvider);
new System.IO.StringWriter : System.Text.StringBuilder * IFormatProvider -> System.IO.StringWriter
Public Sub New (sb As StringBuilder, formatProvider As IFormatProvider)

Parâmetros

sb
StringBuilder

O StringBuilder objeto para escrever.

formatProvider
IFormatProvider

Um objeto que controla a IFormatProvider formatação.

Exceções

ArgumentNullException

sb é null.

Observações

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