StringWriter Sınıf

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

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ği, çift aralıklı bir cümle grubundan sürekli bir paragraf oluşturulmasını ve ardından paragrafın özgün metne dönüştürülmesi işlemini gösterir.

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

Açıklamalar

StringWriter bir dizeye zaman uyumlu veya zaman uyumsuz olarak yazmanızı sağlar. veya yöntemiyle Write(Char) , veya WriteAsync(Char) yöntemini kullanarak Write(String)WriteAsync(String) bir kerede bir dize ile bir karakter yazabilirsiniz. Buna ek olarak, yöntemlerden biriyle zaman uyumsuz olarak bir karakter, karakter dizisi veya dize yazabilir ve ardından satır sonlandırıcısını WriteLineAsync yazabilirsiniz.

Not

Bu tür arabirimini IDisposable uygular, ancak aslında atılacak kaynağı yoktur. Başka bir deyişle, doğrudan çağırarak Dispose() veya (C#'da) veya Using (Visual Basic'te) gibi using bir dil yapısı kullanarak yok saymak gerekli değildir.

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

Bunu yapmak için...	Bu konudaki örneğe bakın...
Bir metin dosyası oluşturun.	Nasıl yapılır: Bir Dosyaya Metin Yazma
Metin dosyasına yazma.	Nasıl yapılır: Bir Dosyaya Metin Yazma
Metin dosyasından okuma.	Nasıl yapılır: Dosyadan Metin Okuma
Dosyaya metin ekleme.	Nasıl yapılır: Günlük Dosyasını Açma ve Sonuna Ekleme File.AppendText FileInfo.AppendText
Dosyanın boyutunu alın.	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 bir Veri Dosyasını Okuma ve Dosyaya Yazma
İkili bir dosyaya yazın.	Nasıl yapılır: Yeni Oluşturulan bir Veri Dosyasını Okuma ve Dosyaya Yazma

Oluşturucular

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)	Belirtilen StringBuilderöğesine yazan sınıfının yeni bir örneğini StringWriter başlatır.
StringWriter(StringBuilder, IFormatProvider)	Belirtilene yazan ve belirtilen StringBuilder biçim sağlayıcısına StringWriter sahip sınıfın yeni bir örneğini başlatır.

Alanlar

CoreNewLine

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

Özellikler

Encoding	Çıkışı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

Close()	Geçerli StringWriter ve temel alınan akışı kapatır.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	nesnesi tarafından TextWriter kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: TextWriter)
Dispose(Boolean)	StringWriter tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak 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ının tüm arabelleklerini 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()	Type Geçerli örneğini 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 Objectöğesinin sığ 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[])	Metin akışına bir karakter dizisi yazar. (Devralındığı yer: TextWriter)
Write(Char[], Int32, Int32)	Dizeye karakterlerin alt dizisini yazar.
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, bu nesnede yöntemini çağırarak metin akışına ToString yazar. (Devralındığı yer: TextWriter)
Write(ReadOnlySpan<Char>)	Geçerli dizeye 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)	Geçerli dizeye bir dize yazar.
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, 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, 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[])	Yöntemiyle aynı semantiği Format(String, Object[]) kullanarak metin akışına biçimlendirilmiş bir dize yazar. (Devralındığı yer: TextWriter)
Write(StringBuilder)	Bir dize oluşturucusunun dize gösterimini geçerli dizeye 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[])	Metin akışına zaman uyumsuz olarak bir karakter dizisi yazar. (Devralındığı yer: TextWriter)
WriteAsync(Char[], Int32, Int32)	Dizeye zaman uyumsuz olarak karakter alt dizisini yazar.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Dizeye karakterlerin bellek bölgesini zaman uyumsuz olarak 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ı ekler. (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[])	Metin akışına bir karakter dizisi 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 ve ardından bir satır sonlandırıcısını yazar. (Devralındığı yer: TextWriter)
WriteLine(Decimal)	Ondalık değerin metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı ekler. (Devralındığı yer: TextWriter)
WriteLine(Double)	8 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar ve ardından bir çizgi sonlandırıcısı ekler. (Devralındığı yer: TextWriter)
WriteLine(Int32)	Metin akışına 4 baytlık imzalı bir tamsayının metin gösterimini ve ardından bir satır sonlandırıcısını yazar. (Devralındığı yer: TextWriter)
WriteLine(Int64)	Metin akışına 8 baytlık imzalı tamsayının metin gösterimini ve ardından bir satır sonlandırıcısını yazar. (Devralındığı yer: TextWriter)
WriteLine(Object)	Bir nesnenin metin gösterimini, bu nesnede yöntemini çağırarak metin akışına ToString yazar ve ardından bir satır sonlandırıcısı ekler. (Devralındığı yer: TextWriter)
WriteLine(ReadOnlySpan<Char>)	Metin gösterimini dizeye bir karakter aralığı ve ardından bir satır sonlandırıcısı yazar.
WriteLine(Single)	Metin akışına 4 baytlık kayan nokta değerinin metin gösterimini ve ardından bir çizgi sonlandırıcısını 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(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, 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, 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[])	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(StringBuilder)	Dize oluşturucusunun metin gösterimini dizeye yazar ve ardından bir satır sonlandırıcısı ekler.
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ı ekler. (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ı ekler. (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 yazar ve ardından bir satır sonlandırıcısı ekler.
WriteLineAsync(Char[])	Zaman uyumsuz olarak metin akışına bir karakter dizisi ve ardından bir satır sonlandırıcı yazar. (Devralındığı yer: TextWriter)
WriteLineAsync(Char[], Int32, Int32)	zaman uyumsuz olarak dizeye karakterlerin alt dizisini yazar ve ardından bir satır sonlandırıcısı ekler.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Karakterlerin bellek bölgesinin dize gösterimini geçerli dizeye zaman uyumsuz olarak yazar ve bunu bir satır sonlandırıcısı izler.
WriteLineAsync(String)	Geçerli dizeye zaman uyumsuz olarak bir dize yazar ve ardından bir satır sonlandırıcısı ekler.
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ı

ConfigureAwait(IAsyncDisposable, Boolean)

Zaman uyumsuz bir atılabilir öğeden döndürülen görevlerde awaits işleminin nasıl gerçekleştirildiğini yapılandırılır.

Ayrıca bkz.

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