StringWriter Třída

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

StringWriter.cs

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

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 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 zápis do řetězce synchronně nebo asynchronně. Znak můžete najednou napsat pomocí Write(Char) metody nebo WriteAsync(Char) metody, řetězce najednou pomocí Write(String) metody nebo WriteAsync(String) metody. Kromě toho můžete napsat znak, pole znaků nebo řetězec následovaný ukončovacím řádkem asynchronně jednou z WriteLineAsync metod.

Note

Tento typ implementuje IDisposable rozhraní, 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 pomocí konstruktoru jazyka, jako je using (v jazyce C#) nebo Using (v 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

Name	Description
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, IFormatProvider)	Inicializuje novou instanci StringWriter třídy, která zapisuje do zadaného StringBuilder a má zadaného zprostředkovatele formátu.
StringWriter(StringBuilder)	Inicializuje novou instanci StringWriter třídy, která zapisuje do zadaného StringBuilder.

Pole

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

Vlastnosti

Name	Description
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í TextWriter. (Zděděno od TextWriter)

Metody

Name	Description
Close()	Zavře aktuální StringWriter a podkladový datový proud.
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 hodnotu 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 MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
ToString()	Vrátí řetězec obsahující znaky zapsané do aktuálního StringWriter stavu.
Write(Boolean)	Zapíše textovou reprezentaci hodnoty do textového Boolean streamu. (Zděděno od TextWriter)
Write(Char)	Zapíše znak do řetězce.
Write(Char[], Int32, Int32)	Zapíše podarray znaků do řetězce.
Write(Char[])	Zapíše pole znaků do textového streamu. (Zděděno od TextWriter)
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, 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, 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)	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[])	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(String)	Zapíše řetězec do aktuálního řetězce.
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[], Int32, Int32)	Zapíše dílčí pole znaků do řetězce asynchronně.
WriteAsync(Char[])	Zapíše pole znaků do textového streamu asynchronně. (Zděděno od TextWriter)
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 hodnoty do textového Boolean streamu 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[], 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(Char[])	Zapíše do textového streamu matici znaků následovanou ukončovacím znakem řádku. (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 ToString metody 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, 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, Object)	Zapíše formátovaný řetězec a nový řádek do textového streamu pomocí stejné sémantiky jako Format(String, Object, Object) metoda. (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) metoda. (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(String)	Zapíše řetězec do textového streamu následovaného ukončovacím znakem řádku. (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[], Int32, Int32)	asynchronně zapíše dílčí pole znaků do řetězce následovaného ukončovacím řádkem.
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(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í

Name	Description
ConfigureAwait(IAsyncDisposable, Boolean)	Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.

Viz také

• StringBuilder
• StringReader
• Vstup/výstup souborů a streamů
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru