StringWriter Sınıf

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

StringWriter.cs

Dizeye TextWriter bilgi yazmak için bir uygular. Bilgiler, temel alınan StringBuilderbir içinde depolanır.

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

public class StringWriter : System.IO.TextWriter

type StringWriter = class
    inherit TextWriter

Public Class StringWriter
Inherits TextWriter

Devralma

Object

MarshalByRefObject

TextWriter

StringWriter

Örnekler

Aşağıdaki kod örneğinde, çift aralıklı tümcelerden oluşan bir gruptan sürekli paragraf oluşturma ve ardından paragrafın özgün metne geri dönüştürülmesi gösterilmektedir.

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

Açıklamalar

StringWriter bir dizeye zaman uyumlu veya zaman uyumsuz olarak yazmanızı sağlar. veya yöntemiyle Write(Char) bir kerede bir karakter, veya WriteAsync(Char) yöntemini kullanarak Write(String)WriteAsync(String) bir kerede bir dize yazabilirsiniz. Buna ek olarak, yöntemlerden biriyle WriteLineAsync zaman uyumsuz olarak bir karakter, karakter dizisi veya dize yazabilirsiniz.

Note

Bu tür arabirimini uygular IDisposable , ancak aslında atılacak kaynağı yoktur. Bu, doğrudan Dispose() çağırarak veya using (C#'de) ya da Using (Visual Basic) gibi bir dil yapısı kullanarak yok edilmesi gerekmediği anlamına gelir.

Aşağıdaki tabloda diğer tipik veya ilgili G/Ç görevlerinin örnekleri listelenmiştir.

Bunu yapmak için...	Bu konudaki örne bakın...
Bir metin dosyası oluşturun.	Nasıl yapılır: Dosyaya Metin Yazma
Metin dosyasına yazın.	Nasıl yapılır: Dosyaya Metin Yazma
Metin dosyasından okuma.	Nasıl yapılır: Dosyadan Metin Okuma
Dosyaya metin ekleyin.	Günlük Dosyasını Açma ve Ekleme File.AppendText FileInfo.AppendText
Dosyanın boyutunu alma.	FileInfo.Length
Bir dosyanın özniteliklerini alın.	File.GetAttributes
Dosyanın özniteliklerini ayarlayın.	File.SetAttributes
Bir dosyanın var olup olmadığını belirleyin.	File.Exists
İkili dosyadan okuma.	Nasıl yapılır: Yeni Oluşturulan Veri Dosyasına Okuma ve Yazma
İkili bir dosyaya yazın.	Nasıl yapılır: Yeni Oluşturulan Veri Dosyasına Okuma ve Yazma

Oluşturucular

Name	Description
StringWriter()	StringWriter sınıfının yeni bir örneğini başlatır.
StringWriter(IFormatProvider)	Belirtilen biçim denetimiyle sınıfının yeni bir örneğini StringWriter başlatır.
StringWriter(StringBuilder, IFormatProvider)	Sınıfın StringWriter belirtilene yazan ve belirtilen StringBuilder biçim sağlayıcısına sahip yeni bir örneğini başlatır.
StringWriter(StringBuilder)	Belirtilen StringWriteröğesine yazan sınıfının yeni bir örneğini StringBuilder başlatır.

Alanlar

Name	Description
CoreNewLine	Bu TextWriteriçin kullanılan yeni satır karakterlerini depolar. (Devralındığı yer: TextWriter)

Özellikler

Name	Description
Encoding	Çıktının Encoding yazıldığı öğesini alır.
FormatProvider	Biçimlendirmeyi denetleen bir nesne alır. (Devralındığı yer: TextWriter)
NewLine	Geçerli TextWritertarafından kullanılan satır sonlandırıcı dizesini alır veya ayarlar. (Devralındığı yer: TextWriter)

Yöntemler

Name	Description
Close()	Geçerli StringWriter ve temel alınan akışı kapatır.
Dispose()	Nesnesi tarafından TextWriter kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: TextWriter)
Dispose(Boolean)	tarafından StringWriter kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
DisposeAsync()	Nesne tarafından TextWriter kullanılan tüm kaynakları zaman uyumsuz olarak serbest bırakır. (Devralındığı yer: TextWriter)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Flush()	Geçerli yazıcı için tüm arabellekleri temizler ve arabelleğe alınan verilerin temel alınan cihaza yazılmasına neden olur. (Devralındığı yer: TextWriter)
FlushAsync()	Geçerli yazıcı için tüm arabellekleri zaman uyumsuz olarak temizler ve arabelleğe alınan verilerin temel alınan cihaza yazılmasına neden olur.
FlushAsync(CancellationToken)	Geçerli yazıcı için tüm arabellekleri zaman uyumsuz olarak temizler ve arabelleğe alınan verilerin temel alınan cihaza yazılmasına neden olur. (Devralındığı yer: TextWriter)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetStringBuilder()	Temel alınan StringBuilderdeğerini döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
ToString()	Şimdiye kadar geçerli StringWriter karaktere yazılan karakterleri içeren bir dize döndürür.
Write(Boolean)	Bir Boolean değerin metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(Char)	Dizeye bir karakter yazar.
Write(Char[], Int32, Int32)	Dizeye karakterlerin alt dizisini yazar.
Write(Char[])	Metin akışına bir karakter dizisi yazar. (Devralındığı yer: TextWriter)
Write(Decimal)	Ondalık değerin metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(Double)	8 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(Int32)	4 baytlık imzalı tamsayının metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(Int64)	8 baytlık imzalı tamsayının metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(Object)	Bir nesnenin metin gösterimini, o nesnede yöntemini çağırarak metin akışına ToString yazar. (Devralındığı yer: TextWriter)
Write(ReadOnlySpan<Char>)	Geçerli dizeye bir karakter aralığının dize gösterimini yazar.
Write(Single)	4 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(String, Object, Object, Object)	Yöntemiyle aynı semantiği Format(String, Object, Object, Object) kullanarak metin akışına biçimlendirilmiş bir dize yazar. (Devralındığı yer: TextWriter)
Write(String, Object, Object)	Yöntemiyle aynı semantiği Format(String, Object, Object) kullanarak metin akışına biçimlendirilmiş bir dize yazar. (Devralındığı yer: TextWriter)
Write(String, Object)	Yöntemiyle aynı semantiği Format(String, Object) kullanarak metin akışına biçimlendirilmiş bir dize yazar. (Devralındığı yer: TextWriter)
Write(String, Object[])	Yöntemiyle aynı semantiği Format(String, Object[]) kullanarak metin akışına biçimlendirilmiş bir dize yazar. (Devralındığı yer: TextWriter)
Write(String, ReadOnlySpan<Object>)	ile aynı semantiği Format(String, ReadOnlySpan<Object>)kullanarak metin akışına biçimlendirilmiş bir dize yazar. (Devralındığı yer: TextWriter)
Write(String)	Geçerli dizeye bir dize yazar.
Write(StringBuilder)	Geçerli dizeye bir dize oluşturucusunun dize gösterimini yazar.
Write(UInt32)	4 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(UInt64)	8 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
WriteAsync(Char)	Dizeye zaman uyumsuz olarak bir karakter yazar.
WriteAsync(Char[], Int32, Int32)	Dizeye zaman uyumsuz olarak karakterlerin alt dizisini yazar.
WriteAsync(Char[])	Metin akışına zaman uyumsuz olarak bir karakter dizisi yazar. (Devralındığı yer: TextWriter)
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Zaman uyumsuz olarak dizeye karakterlerden oluşan bir bellek bölgesi yazar.
WriteAsync(String)	Geçerli dizeye zaman uyumsuz olarak bir dize yazar.
WriteAsync(StringBuilder, CancellationToken)	Dize oluşturucusunun metin gösterimini zaman uyumsuz olarak dizeye yazar.
WriteLine()	Metin akışına bir satır sonlandırıcı yazar. (Devralındığı yer: TextWriter)
WriteLine(Boolean)	Bir Boolean değerin metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLine(Char)	Metin akışına bir karakter ve ardından bir satır sonlandırıcı yazar. (Devralındığı yer: TextWriter)
WriteLine(Char[], Int32, Int32)	Metin akışına karakterlerin bir alt dizisini yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLine(Char[])	Metin akışına bir karakter dizisi ve ardından bir satır sonlandırıcı yazar. (Devralındığı yer: TextWriter)
WriteLine(Decimal)	Bir ondalık değerin metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLine(Double)	Metin akışına 8 baytlık kayan nokta değerinin metin gösterimini ve ardından bir satır sonlandırıcı yazar. (Devralındığı yer: TextWriter)
WriteLine(Int32)	4 baytlık imzalı bir tamsayının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLine(Int64)	8 baytlık imzalı bir tamsayının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLine(Object)	Bir nesnenin metin gösterimini, bu nesnede yöntemini çağırarak ToString ve ardından bir satır sonlandırıcısı çağırarak metin akışına yazar. (Devralındığı yer: TextWriter)
WriteLine(ReadOnlySpan<Char>)	Metin gösterimini dizeye bir karakter aralığı ve ardından bir satır sonlandırıcı yazar.
WriteLine(Single)	Metin akışına 4 baytlık kayan nokta değerinin metin gösterimini ve ardından bir satır sonlandırıcı yazar. (Devralındığı yer: TextWriter)
WriteLine(String, Object, Object, Object)	ile aynı semantiği Format(String, Object)kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar. (Devralındığı yer: TextWriter)
WriteLine(String, Object, Object)	Yöntemiyle aynı semantiği Format(String, Object, Object) kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar. (Devralındığı yer: TextWriter)
WriteLine(String, Object)	Yöntemiyle aynı semantiği Format(String, Object) kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar. (Devralındığı yer: TextWriter)
WriteLine(String, Object[])	ile aynı semantiği Format(String, Object)kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar. (Devralındığı yer: TextWriter)
WriteLine(String, ReadOnlySpan<Object>)	ile aynı semantiği Format(String, ReadOnlySpan<Object>)kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar. (Devralındığı yer: TextWriter)
WriteLine(String)	Metin akışına bir dize ve ardından bir satır sonlandırıcı yazar. (Devralındığı yer: TextWriter)
WriteLine(StringBuilder)	Dize oluşturucusunun metin gösterimini dizeye yazar ve ardından bir satır sonlandırıcısı yazar.
WriteLine(UInt32)	4 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLine(UInt64)	8 baytlık işaretsiz tamsayının metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLineAsync()	Zaman uyumsuz olarak metin akışına bir satır sonlandırıcı yazar. (Devralındığı yer: TextWriter)
WriteLineAsync(Char)	Zaman uyumsuz olarak dizeye bir karakter, ardından bir satır sonlandırıcı yazar.
WriteLineAsync(Char[], Int32, Int32)	zaman uyumsuz olarak dizeye bir karakter alt dizisi yazar ve ardından bir satır sonlandırıcısı yazar.
WriteLineAsync(Char[])	Zaman uyumsuz olarak metin akışına bir karakter dizisi yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Karakterlerin bellek bölgesinin dize gösterimini geçerli dizeye zaman uyumsuz olarak yazar ve ardından bir satır sonlandırıcı yazar.
WriteLineAsync(String)	Geçerli dizeye zaman uyumsuz olarak bir dize yazar ve ardından bir satır sonlandırıcısı yazar.
WriteLineAsync(StringBuilder, CancellationToken)	Dize oluşturucusunun dize gösterimini geçerli dizeye zaman uyumsuz olarak yazar ve ardından bir satır sonlandırıcısı ekler.

Uzantı Metotları

Name	Description
ConfigureAwait(IAsyncDisposable, Boolean)	Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirileceğini yapılandırılır.

Ayrıca bkz.

• StringBuilder
• StringReader
• Dosya ve Akış G/Ç'si
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Dosyaya Metin Yazma