StreamWriter Sınıf

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

StreamWriter.cs

Belirli bir kodlamadaki bir akışa karakter yazmak için bir TextWriter uygular.

public ref class StreamWriter : System::IO::TextWriter

public class StreamWriter : System.IO.TextWriter

type StreamWriter = class
    inherit TextWriter

Public Class StreamWriter
Inherits TextWriter

Devralma

Object

MarshalByRefObject

TextWriter

StreamWriter

Örnekler

Aşağıdaki örnekte, C sürücüsündeki dizinleri listeleyen bir dosya yazmak için StreamWriter nesnesinin nasıl kullanılacağı ve ardından her dizin adını okumak ve görüntülemek için bir StreamReader nesnesi nasıl kullanılacağı gösterilmektedir. İyi bir uygulama, yönetilmeyen kaynakların doğru şekilde atılması için bu nesneleri bir using deyiminde kullanmaktır. using deyimi, onu kullanan kod tamamlandığında nesnedeki Dispose otomatik olarak çağırır. Bu örnekte kullanılan oluşturucu, Windows Mağazası Uygulamalarında kullanılmak üzere desteklenmez.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.IO;

namespace StreamReadWrite
{
    class Program
    {
        static void Main(string[] args)
        {
            // Get the directories currently on the C drive.
            DirectoryInfo[] cDirs = new DirectoryInfo(@"c:\").GetDirectories();

            // Write each directory name to a file.
            using (StreamWriter sw = new StreamWriter("CDriveDirs.txt"))
            {
                foreach (DirectoryInfo dir in cDirs)
                {
                    sw.WriteLine(dir.Name);
                }
            }

            // Read and show each line from the file.
            string line = "";
            using (StreamReader sr = new StreamReader("CDriveDirs.txt"))
            {
                while ((line = sr.ReadLine()) != null)
                {
                    Console.WriteLine(line);
                }
            }
        }
    }
}

Imports System.IO
Class Program

    Shared Sub Main()

        ' Get the directories currently on the C drive.
        Dim cDirs As DirectoryInfo() = New DirectoryInfo("c:\").GetDirectories()

        ' Write each directory name to a file.
        Using sw As StreamWriter = New StreamWriter("CDriveDirs.txt")
            For Each Dir As DirectoryInfo In cDirs
                sw.WriteLine(Dir.Name)
            Next
        End Using

        'Read and show each line from the file.
        Dim line As String = ""
        Using sr As StreamReader = New StreamReader("CDriveDirs.txt")
            Do
                line = sr.ReadLine()
                Console.WriteLine(line)
            Loop Until line Is Nothing
        End Using


    End Sub

End Class

Açıklamalar

StreamWriter belirli bir kodlamadaki karakter çıkışı için, Stream türetilen sınıflar ise bayt girişi ve çıkışı için tasarlanmıştır.

Önemli

Bu tür IDisposable arabirimini uygular. Türünü kullanmayı bitirdiğinizde, doğrudan veya dolaylı olarak atmalısınız. Türü doğrudan atmak için Dispose yöntemini bir try/catch bloğunda çağırın. Bunu dolaylı olarak atmak için using (C#'de) veya Using (Visual Basic'te) gibi bir dil yapısı kullanın. Daha fazla bilgi için IDisposable arabirimi konusunun "IDisposable Uygulayan Bir Nesne Kullanma" bölümüne bakın.

StreamWriter aksi belirtilmedikçe varsayılan olarak UTF8Encoding örneğini kullanır. Bu UTF8Encoding örneği bayt sırası işareti (BOM) olmadan oluşturulur, bu nedenle GetPreamble yöntemi boş bir bayt dizisi döndürür. Bu oluşturucu için varsayılan UTF-8 kodlaması geçersiz baytlarda bir özel durum oluşturur. Bu davranış, Encoding.UTF8 özelliğindeki kodlama nesnesi tarafından sağlanan davranıştan farklıdır. Ürün reçetesini belirtmek ve geçersiz baytlarda özel durum oluşturup oluşturmadığını belirlemek için, StreamWriter(String, Boolean, Encoding) veya StreamWritergibi bir kodlama nesnesini parametre olarak kabul eden bir oluşturucu kullanın.

Varsayılan olarak, StreamWriter iş parçacığı güvenli değildir. İş parçacığı güvenli sarmalayıcı için bkz. TextWriter.Synchronized.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Oluşturucular

StreamWriter(Stream)	UTF-8 kodlamasını ve varsayılan arabellek boyutunu kullanarak belirtilen akış için StreamWriter sınıfının yeni bir örneğini başlatır.
StreamWriter(Stream, Encoding)	Belirtilen kodlamayı ve varsayılan arabellek boyutunu kullanarak belirtilen akış için StreamWriter sınıfının yeni bir örneğini başlatır.
StreamWriter(Stream, Encoding, Int32)	Belirtilen kodlama ve arabellek boyutunu kullanarak belirtilen akış için StreamWriter sınıfının yeni bir örneğini başlatır.
StreamWriter(Stream, Encoding, Int32, Boolean)	Belirtilen kodlama ve arabellek boyutunu kullanarak belirtilen akış için StreamWriter sınıfının yeni bir örneğini başlatır ve isteğe bağlı olarak akışı açık bırakır.
StreamWriter(String)	Varsayılan kodlama ve arabellek boyutunu kullanarak belirtilen dosya için StreamWriter sınıfının yeni bir örneğini başlatır.
StreamWriter(String, Boolean)	Varsayılan kodlama ve arabellek boyutunu kullanarak belirtilen dosya için StreamWriter sınıfının yeni bir örneğini başlatır. Dosya varsa üzerine yazılabilir veya üzerine eklenebilir. Dosya yoksa, bu oluşturucu yeni bir dosya oluşturur.
StreamWriter(String, Boolean, Encoding)	Belirtilen kodlamayı ve varsayılan arabellek boyutunu kullanarak belirtilen dosya için StreamWriter sınıfının yeni bir örneğini başlatır. Dosya varsa üzerine yazılabilir veya üzerine eklenebilir. Dosya yoksa, bu oluşturucu yeni bir dosya oluşturur.
StreamWriter(String, Boolean, Encoding, Int32)	Belirtilen kodlama ve arabellek boyutunu kullanarak belirtilen yolda belirtilen dosya için StreamWriter sınıfının yeni bir örneğini başlatır. Dosya varsa üzerine yazılabilir veya üzerine eklenebilir. Dosya yoksa, bu oluşturucu yeni bir dosya oluşturur.
StreamWriter(String, Encoding, FileStreamOptions)	Belirtilen kodlamayı kullanarak belirtilen dosya için StreamWriter sınıfının yeni bir örneğini başlatır ve belirtilen FileStreamOptions nesnesiyle yapılandırılır.
StreamWriter(String, FileStreamOptions)	Varsayılan kodlamayı kullanarak belirtilen dosya için StreamWriter sınıfının yeni bir örneğini başlatır ve belirtilen FileStreamOptions nesnesiyle yapılandırılır.

Alanlar

CoreNewLine	Bu TextWriteriçin kullanılan yeni satır karakterlerini depolar. (Devralındığı yer: TextWriter)
Null	Yazılabilen ancak okunmayan bir yedekleme deposu olmayan bir StreamWriter sağlar.

Özellikler

AutoFlush	Write(Char)yapılan her çağrıdan sonra StreamWriter arabelleğinin temel alınan akışa boşaltılıp temizlenmeyeceğini belirten bir değer alır veya ayarlar.
BaseStream	Bir yedekleme deposuyla arabirim oluşturan temel alınan akışı alır.
Encoding	Çıkışın yazıldığı Encoding 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 StreamWriter nesnesini 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()	TextWriter nesnesi tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: TextWriter)
Dispose(Boolean)	Arabelleğe alınan verilerin temel alınan akışa yazılmasını sağlar, StreamWritertarafından kullanılan yönetilmeyen kaynakları ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
DisposeAsync()	Arabelleğe alınan tüm verileri zaman uyumsuz olarak temel alınan akışa yazar ve StreamWritertarafından kullanılan yönetilmeyen kaynakları serbest bırakır.
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 akışa yazılmasına neden olur.
FlushAsync()	Bu akış 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)	Bu akış için tüm arabellekleri zaman uyumsuz olarak temizler ve arabelleğe alınan verilerin temel alınan cihaza yazılmasına neden olur.
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)
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 nesnesinin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
Write(Boolean)	Bir Boolean değerinin metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(Char)	Akışa bir karakter yazar.
Write(Char[])	Akışa bir karakter dizisi yazar.
Write(Char[], Int32, Int32)	Akışa bir karakter alt dizisi 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)	Nesne üzerinde ToString yöntemini çağırarak bir nesnenin metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(ReadOnlySpan<Char>)	Akışa bir karakter aralığı yazar.
Write(Single)	4 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(String)	Akışa bir dize yazar.
Write(String, Object)	Format(String, Object) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.
Write(String, Object, Object)	Format(String, Object, Object) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.
Write(String, Object, Object, Object)	Format(String, Object, Object, Object) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.
Write(String, Object[])	Format(String, Object[]) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.
Write(String, ReadOnlySpan<Object>)	Format(String, ReadOnlySpan<Object>)ile aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize yazar. (Devralındığı yer: TextWriter)
Write(StringBuilder)	Metin akışına bir dize oluşturucu yazar. (Devralındığı yer: TextWriter)
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)	Akışa 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)	Zaman uyumsuz olarak akışa bir karakter alt dizisi yazar.
WriteAsync(ReadOnlyMemory<Char>, CancellationToken)	Akışa zaman uyumsuz olarak bir karakter bellek bölgesi yazar.
WriteAsync(String)	Akışa zaman uyumsuz olarak bir dize yazar.
WriteAsync(StringBuilder, CancellationToken)	Zaman uyumsuz olarak metin akışına bir dize oluşturucu yazar. (Devralındığı yer: TextWriter)
WriteLine()	Metin akışına bir satır sonlandırıcı yazar. (Devralındığı yer: TextWriter)
WriteLine(Boolean)	Bir Boolean değerinin 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[])	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 yazar ve ardından bir satır sonlandırıcısı 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 ToString yöntemini çağırarak ve ardından bir satır sonlandırıcısı çağırarak metin akışına yazar. (Devralındığı yer: TextWriter)
WriteLine(ReadOnlySpan<Char>)	Bir karakter aralığının metin gösterimini akışa yazar 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 satır sonlandırıcı yazar. (Devralındığı yer: TextWriter)
WriteLine(String)	Akışa bir dize ve ardından bir satır sonlandırıcı yazar.
WriteLine(String, Object)	Format(String, Object) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize ve yeni bir satır yazar.
WriteLine(String, Object, Object)	Format(String, Object, Object) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize ve yeni bir satır yazar.
WriteLine(String, Object, Object, Object)	Format(String, Object)ile aynı semantiği kullanarak biçimlendirilmiş bir dizeyi ve yeni bir satırı akışa yazar.
WriteLine(String, Object[])	Format(String, Object)ile aynı semantiği kullanarak biçimlendirilmiş bir dizeyi ve yeni bir satırı akışa yazar.
WriteLine(String, ReadOnlySpan<Object>)	Format(String, ReadOnlySpan<Object>)ile aynı semantiği kullanarak metin akışına biçimlendirilmiş bir dize ve yeni bir satır yazar. (Devralındığı yer: TextWriter)
WriteLine(StringBuilder)	Bir dize oluşturucusunun metin gösterimini metin akışına yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
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()	Akışa zaman uyumsuz olarak bir satır sonlandırıcı yazar.
WriteLineAsync(Char)	Zaman uyumsuz olarak akışa 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 yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLineAsync(Char[], Int32, Int32)	Zaman uyumsuz olarak akışa karakterlerin alt dizisini ve ardından bir satır sonlandırıcı yazar.
WriteLineAsync(ReadOnlyMemory<Char>, CancellationToken)	Bir karakter bellek bölgesinin metin gösterimini akışa zaman uyumsuz olarak yazar ve ardından bir satır sonlandırıcı yazar.
WriteLineAsync(String)	Zaman uyumsuz olarak akışa bir dize yazar ve ardından bir satır sonlandırıcısı ekler.
WriteLineAsync(StringBuilder, CancellationToken)	Bir dize oluşturucusunun metin gösterimini zaman uyumsuz olarak metin akışına yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)

Uzantı Metotları

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.

• Stream
• StreamReader
• Encoder
• Encoding
• Dosya ve Akış G/Ç
• Nasıl yapılır: Dosya Metin Okuma
• Nasıl yapılır: Dosya Metin Yazma
• Nasıl yapılır: Yeni Oluşturulan Veri Dosyası Okuma ve Yazma