StringWriter Třída

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

StringWriter.cs

Implementuje TextWriter pro zápis informací do řetězce. Informace jsou uloženy v podkladové StringBuilder.

public ref class StringWriter : System::IO::TextWriter

public class StringWriter : System.IO.TextWriter

type StringWriter = class
    inherit TextWriter

Public Class StringWriter
Inherits TextWriter

Dědičnost

Object

MarshalByRefObject

TextWriter

StringWriter

Příklady

Následující příklad kódu ukazuje vytvoření souvislého odstavce ze skupiny dvojitých mezer vět a následný převod odstavce zpět na původní text.

using namespace System;
using namespace System::IO;
int main()
{
   String^ textReaderText = "TextReader is the abstract base "
   "class of StreamReader and StringReader, which read "
   "characters from streams and strings, respectively.\n\n"
   "Create an instance of TextReader to open a text file "
   "for reading a specified range of characters, or to "
   "create a reader based on an existing stream.\n\n"
   "You can also use an instance of TextReader to read "
   "text from a custom backing store using the same "
   "APIs you would use for a string or a stream.\n\n";
   Console::WriteLine(  "Original text:\n\n{0}", textReaderText );

   // From textReaderText, create a continuous paragraph 
   // with two spaces between each sentence.
      String^ aLine;
   String^ aParagraph;
   StringReader^ strReader = gcnew StringReader( textReaderText );
   while ( true )
   {
      aLine = strReader->ReadLine();
      if ( aLine != nullptr )
      {
         aParagraph = String::Concat( aParagraph, aLine,  " " );
      }
      else
      {
         aParagraph = String::Concat( aParagraph,  "\n" );
         break;
      }
   }

   Console::WriteLine(  "Modified text:\n\n{0}", aParagraph );
   
   // Re-create textReaderText from aParagraph.
   int intCharacter;
   Char convertedCharacter;
   StringWriter^ strWriter = gcnew StringWriter;
   strReader = gcnew StringReader( aParagraph );
   while ( true )
   {
      intCharacter = strReader->Read();
      
      // Check for the end of the string 
      // before converting to a character.
      if ( intCharacter == -1 )
            break;

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

   Console::WriteLine(  "\nOriginal text:\n\n{0}", strWriter->ToString() );
}

using System;
using System.IO;

class StringRW
{
    static void Main()
    {
        string textReaderText = "TextReader is the abstract base " +
            "class of StreamReader and StringReader, which read " +
            "characters from streams and strings, respectively.\n\n" +

            "Create an instance of TextReader to open a text file " +
            "for reading a specified range of characters, or to " +
            "create a reader based on an existing stream.\n\n" +

            "You can also use an instance of TextReader to read " +
            "text from a custom backing store using the same " +
            "APIs you would use for a string or a stream.\n\n";

        Console.WriteLine("Original text:\n\n{0}", textReaderText);

        // From textReaderText, create a continuous paragraph
        // with two spaces between each sentence.
        string aLine, aParagraph = null;
        StringReader strReader = new StringReader(textReaderText);
        while(true)
        {
            aLine = strReader.ReadLine();
            if(aLine != null)
            {
                aParagraph = aParagraph + aLine + " ";
            }
            else
            {
                aParagraph = aParagraph + "\n";
                break;
            }
        }
        Console.WriteLine("Modified text:\n\n{0}", aParagraph);

        // Re-create textReaderText from aParagraph.
        int intCharacter;
        char convertedCharacter;
        StringWriter strWriter = new StringWriter();
        strReader = new StringReader(aParagraph);
        while(true)
        {
            intCharacter = strReader.Read();

            // Check for the end of the string
            // before converting to a character.
            if(intCharacter == -1) break;

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

                // Bypass the spaces between sentences.
                strReader.Read();
                strReader.Read();
            }
            else
            {
                strWriter.Write(convertedCharacter);
            }
        }
        Console.WriteLine("\nOriginal text:\n\n{0}",
            strWriter.ToString());
    }
}

Option Explicit
Option Strict

Imports System.IO

Public Class StrReader

    Shared Sub Main()
    
        Dim textReaderText As String = "TextReader is the " & _
            "abstract base class of StreamReader and " & _
            "StringReader, which read characters from streams " & _
            "and strings, respectively." & _
            vbCrLf & vbCrLf & _
            "Create an instance of TextReader to open a text " & _
            "file for reading a specified range of characters, " & _
            "or to create a reader based on an existing stream." & _
            vbCrLf & vbCrLf & _
            "You can also use an instance of TextReader to read " & _
            "text from a custom backing store using the same " & _
            "APIs you would use for a string or a stream." & _
            vbCrLf & vbCrLf

        Console.WriteLine("Original text:" & vbCrLf & vbCrLf & _
            textReaderText)

        ' From textReaderText, create a continuous paragraph 
        ' with two spaces between each sentence.
        Dim aLine, aParagraph As String
        Dim strReader As New StringReader(textReaderText)
        While True
            aLine = strReader.ReadLine()
            If aLine Is Nothing Then
                aParagraph = aParagraph & vbCrLf
                Exit While
            Else
                aParagraph = aParagraph & aLine & " "
            End If
        End While
        Console.WriteLine("Modified text:" & vbCrLf & vbCrLf & _ 
            aParagraph)
    
        ' Re-create textReaderText from aParagraph.
        Dim intCharacter As Integer 
        Dim convertedCharacter As Char 
        Dim strWriter As New StringWriter()
        strReader = New StringReader(aParagraph)
        While True
            intCharacter = strReader.Read()

            ' Check for the end of the string 
            ' before converting to a character.
            If intCharacter = -1 Then
                Exit While
            End If

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

                ' Bypass the spaces between sentences.
                strReader.Read()
                strReader.Read()
            Else
                strWriter.Write(convertedCharacter)
            End If
        End While
        Console.WriteLine(vbCrLf & "Original text:" & vbCrLf & _ 
            vbCrLf & strWriter.ToString())

    End Sub
End Class

Poznámky

StringWriter umožňuje zapisovat do řetězce synchronně nebo asynchronně. Znak můžete najednou napsat pomocí Write(Char) nebo metody WriteAsync(Char), řetězce najednou pomocí Write(String) nebo metody WriteAsync(String). Kromě toho můžete napsat znak, pole znaků nebo řetězec následovaný ukončovacím znakem řádku asynchronně s jednou z WriteLineAsync metod.

Poznámka

Tento typ implementuje rozhraní IDisposable, ale ve skutečnosti nemá žádné prostředky k odstranění. To znamená, že jeho odstranění přímým voláním Dispose() nebo použitím konstruktoru jazyka, jako je using (v jazyce C#) nebo Using (v jazyce Visual Basic), není nutné.

Následující tabulka uvádí příklady jiných typických nebo souvisejících vstupně-výstupních úloh.

Chcete-li to provést...	Podívejte se na příklad v tomto tématu...
Vytvořte textový soubor.	Postupy: Zápis textu do souboru
Zápis do textového souboru	Postupy: Zápis textu do souboru
Čtení z textového souboru	Postupy: Čtení textu ze souboru
Připojte text k souboru.	Postupy: Otevření a připojení k souboru protokolu File.AppendText FileInfo.AppendText
Získejte velikost souboru.	FileInfo.Length
Získá atributy souboru.	File.GetAttributes
Nastavte atributy souboru.	File.SetAttributes
Určete, jestli soubor existuje.	File.Exists
Čtení z binárního souboru	Postupy: Čtení a zápis do nově vytvořeného datového souboru
Zápis do binárního souboru	Postupy: Čtení a zápis do nově vytvořeného datového souboru

Konstruktory

StringWriter()	Inicializuje novou instanci StringWriter třídy.
StringWriter(IFormatProvider)	Inicializuje novou instanci StringWriter třídy pomocí zadaného ovládacího prvku formátu.
StringWriter(StringBuilder)	Inicializuje novou instanci StringWriter třídy, která zapisuje do zadané StringBuilder.
StringWriter(StringBuilder, IFormatProvider)	Inicializuje novou instanci StringWriter třídy, která zapisuje do zadané StringBuilder a má zadaného zprostředkovatele formátu.

Pole

CoreNewLine

Ukládá znaky nového řádku použité pro tento TextWriter. (Zděděno od TextWriter)

Vlastnosti

Encoding	Získá Encoding, ve kterém je výstup zapsán.
FormatProvider	Získá objekt, který řídí formátování. (Zděděno od TextWriter)
NewLine	Získá nebo nastaví ukončovací řetězec řádku používaný aktuálním TextWriter. (Zděděno od TextWriter)

Metody

Close()	Zavře aktuální StringWriter a podkladový datový proud.
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané objektem TextWriter. (Zděděno od TextWriter)
Dispose(Boolean)	Uvolní nespravované prostředky používané StringWriter a volitelně uvolní spravované prostředky.
DisposeAsync()	Asynchronně uvolní všechny prostředky používané objektem TextWriter. (Zděděno od TextWriter)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Flush()	Vymaže všechny vyrovnávací paměti pro aktuální zapisovač a způsobí zápis všech dat uložených do vyrovnávací paměti do podkladového zařízení. (Zděděno od TextWriter)
FlushAsync()	Asynchronně vymaže všechny vyrovnávací paměti pro aktuální zapisovač a způsobí zápis všech uložených dat do základního zařízení.
FlushAsync(CancellationToken)	Asynchronně vymaže všechny vyrovnávací paměti pro aktuální zapisovač a způsobí zápis všech uložených dat do základního zařízení. (Zděděno od TextWriter)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetStringBuilder()	Vrátí podkladovou StringBuilder.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního objektu MarshalByRefObject. (Zděděno od MarshalByRefObject)
ToString()	Vrátí řetězec obsahující znaky zapsané do aktuálního StringWriter dosud.
Write(Boolean)	Zapíše textovou reprezentaci hodnoty Boolean do textového streamu. (Zděděno od TextWriter)
Write(Char)	Zapíše znak do řetězce.
Write(Char[])	Zapíše pole znaků do textového streamu. (Zděděno od TextWriter)
Write(Char[], Int32, Int32)	Zapíše podarray znaků do řetězce.
Write(Decimal)	Zapíše textovou reprezentaci desetinné hodnoty do textového streamu. (Zděděno od TextWriter)
Write(Double)	Zapíše textovou reprezentaci hodnoty s plovoucí desetinou čárkou 8 bajtů do textového datového proudu. (Zděděno od TextWriter)
Write(Int32)	Zapíše textovou reprezentaci 4bajtů podepsaného celé číslo do textového streamu. (Zděděno od TextWriter)
Write(Int64)	Zapíše textovou reprezentaci 8 bajtového celého čísla do textového streamu. (Zděděno od TextWriter)
Write(Object)	Zapíše textovou reprezentaci objektu do textového datového proudu voláním ToString metody na daném objektu. (Zděděno od TextWriter)
Write(ReadOnlySpan<Char>)	Zapíše řetězcovou reprezentaci rozsahu znaků do aktuálního řetězce.
Write(Single)	Zapíše textovou reprezentaci 4bajtů s plovoucí desetinou čárkou do textového streamu. (Zděděno od TextWriter)
Write(String)	Zapíše řetězec do aktuálního řetězce.
Write(String, Object)	Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object) metoda. (Zděděno od TextWriter)
Write(String, Object, Object)	Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object, Object) metoda. (Zděděno od TextWriter)
Write(String, Object, Object, Object)	Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object, Object, Object) metoda. (Zděděno od TextWriter)
Write(String, Object[])	Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, Object[]) metoda. (Zděděno od TextWriter)
Write(String, ReadOnlySpan<Object>)	Zapíše formátovaný řetězec do textového streamu pomocí stejné sémantiky jako Format(String, ReadOnlySpan<Object>). (Zděděno od TextWriter)
Write(StringBuilder)	Zapíše řetězcovou reprezentaci tvůrce řetězců do aktuálního řetězce.
Write(UInt32)	Zapíše textovou reprezentaci 4bajtů bez znaménka do textového streamu. (Zděděno od TextWriter)
Write(UInt64)	Zapíše textovou reprezentaci 8bajtů bez znaménka do textového streamu. (Zděděno od TextWriter)
WriteAsync(Char)	Zapíše znak do řetězce asynchronně.
WriteAsync(Char[])	Zapíše pole znaků do textového streamu asynchronně. (Zděděno od TextWriter)
WriteAsync(Char[], Int32, Int32)	Zapíše dílčí pole znaků do řetězce asynchronně.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Asynchronně zapíše do řetězce oblast paměti znaků.
WriteAsync(String)	Zapíše řetězec do aktuálního řetězce asynchronně.
WriteAsync(StringBuilder, CancellationToken)	Asynchronně zapíše textovou reprezentaci tvůrce řetězců do řetězce.
WriteLine()	Zapíše ukončovací znak řádku do textového streamu. (Zděděno od TextWriter)
WriteLine(Boolean)	Zapíše textovou reprezentaci Boolean hodnoty do textového datového proudu následovaného ukončovacím znakem řádku. (Zděděno od TextWriter)
WriteLine(Char)	Zapíše znak do textového streamu následovaný ukončovacím znakem řádku. (Zděděno od TextWriter)
WriteLine(Char[])	Zapíše do textového streamu matici znaků následovanou ukončovacím znakem řádku. (Zděděno od TextWriter)
WriteLine(Char[], Int32, Int32)	Zapíše dílčí pole znaků do textového streamu následovaného ukončovacím řádkem. (Zděděno od TextWriter)
WriteLine(Decimal)	Zapíše textovou reprezentaci desetinné hodnoty do textového datového proudu následovanou ukončovacím řádkem. (Zděděno od TextWriter)
WriteLine(Double)	Zapíše textovou reprezentaci 8 bajtové hodnoty s plovoucí desetinou čárkou do textového datového proudu následovaného ukončovacím znakem řádku. (Zděděno od TextWriter)
WriteLine(Int32)	Zapíše textovou reprezentaci 4 bajtového celého čísla do textového streamu následovaného ukončovacím řádkem. (Zděděno od TextWriter)
WriteLine(Int64)	Zapíše textovou reprezentaci 8 bajtového celého čísla do textového streamu následovaného ukončovacím řádkem. (Zděděno od TextWriter)
WriteLine(Object)	Zapíše textovou reprezentaci objektu do textového streamu voláním metody ToString na daném objektu následovanou ukončovacím znakem řádku. (Zděděno od TextWriter)
WriteLine(ReadOnlySpan<Char>)	Zapíše textovou reprezentaci rozsahu znaků do řetězce následovaného ukončovacím znakem řádku.
WriteLine(Single)	Zapíše textovou reprezentaci 4bajtů s plovoucí desetinou čárkou do textového datového proudu následovaného ukončovacím znakem řádku. (Zděděno od TextWriter)
WriteLine(String)	Zapíše řetězec do textového streamu následovaného ukončovacím znakem řádku. (Zděděno od TextWriter)
WriteLine(String, Object)	Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako metoda Format(String, Object). (Zděděno od TextWriter)
WriteLine(String, Object, Object)	Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako metoda Format(String, Object, Object). (Zděděno od TextWriter)
WriteLine(String, Object, Object, Object)	Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako Format(String, Object). (Zděděno od TextWriter)
WriteLine(String, Object[])	Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako Format(String, Object). (Zděděno od TextWriter)
WriteLine(String, ReadOnlySpan<Object>)	Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako Format(String, ReadOnlySpan<Object>). (Zděděno od TextWriter)
WriteLine(StringBuilder)	Zapíše textovou reprezentaci tvůrce řetězců do řetězce následovaného ukončovacím znakem řádku.
WriteLine(UInt32)	Zapíše textovou reprezentaci 4bajtů bez znaménka do textového datového proudu následovaného ukončovacím znakem řádku. (Zděděno od TextWriter)
WriteLine(UInt64)	Zapíše textovou reprezentaci 8bajtů bez znaménka do textového datového proudu následovaného ukončovacím znakem řádku. (Zděděno od TextWriter)
WriteLineAsync()	Asynchronně zapíše ukončovací znak řádku do textového streamu. (Zděděno od TextWriter)
WriteLineAsync(Char)	Asynchronně zapíše znak do řetězce následovaný ukončovacím znakem řádku.
WriteLineAsync(Char[])	Asynchronně zapíše pole znaků do textového datového proudu následovaného ukončovacím řádkem. (Zděděno od TextWriter)
WriteLineAsync(Char[], Int32, Int32)	asynchronně zapíše dílčí pole znaků do řetězce následovaného ukončovacím řádkem.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Asynchronně zapíše řetězcovou reprezentaci oblasti paměti znaků do aktuálního řetězce následovanou ukončovacím znakem řádku.
WriteLineAsync(String)	Asynchronně zapíše řetězec do aktuálního řetězce následovaného ukončovacím znakem řádku.
WriteLineAsync(StringBuilder, CancellationToken)	Asynchronně zapíše řetězcovou reprezentaci tvůrce řetězců do aktuálního řetězce následovaného ukončovacím znakem řádku.

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.

Viz také

• StringBuilder
• StringReader
• soubor a streamování vstupně-výstupních
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru