StreamWriter Sınıf

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

StreamWriter.cs

Belirli bir TextWriter kodlamadaki bir akışa karakter yazmak için bir 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, StreamWriter C sürücüsündeki dizinleri listeleyen bir dosya yazmak için nesnesinin nasıl kullanılacağı ve ardından her dizin adını okumak ve görüntülemek için bir StreamReader nesnenin 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. deyimi, using kullanan kod tamamlandığında nesnede otomatik olarak çağrır Dispose . Bu örnekte kullanılan oluşturucu Windows Mağazası Uygulamalarında kullanılmak üzere desteklenmiyor.

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 tasarlanırken, öğesinden Stream türetilen sınıflar bayt girişi ve çıkışı için tasarlanmıştır.

Önemli

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

StreamWriter aksi belirtilmedikçe varsayılan olarak öğesinin bir örneğini UTF8Encoding kullanır. Bu örneği UTF8Encoding 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ış, özelliğindeki kodlama nesnesi Encoding.UTF8 tarafından sağlanan davranıştan farklıdır. Bom belirtmek ve geçersiz baytlarda özel durum oluşturup oluşturmadığını belirlemek için, veya StreamWritergibi StreamWriter(String, Boolean, Encoding) bir kodlama nesnesini parametre olarak kabul eden bir oluşturucu kullanın.

Varsayılan olarak, bir 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ı StreamWriter ve varsayılan arabellek boyutunu kullanarak belirtilen akış için sınıfının yeni bir örneğini başlatır.
StreamWriter(Stream, Encoding)	Belirtilen kodlamayı StreamWriter ve varsayılan arabellek boyutunu kullanarak belirtilen akış için 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 sınıfının yeni bir örneğini StreamWriter başlatır.
StreamWriter(Stream, Encoding, Int32, Boolean)	Belirtilen kodlama ve arabellek boyutunu kullanarak belirtilen akış için sınıfının yeni bir örneğini StreamWriter 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 sınıfının yeni bir örneğini StreamWriter başlatır.
StreamWriter(String, Boolean)	Varsayılan kodlama ve arabellek boyutunu kullanarak belirtilen dosya için sınıfının yeni bir örneğini StreamWriter 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ı StreamWriter ve varsayılan arabellek boyutunu kullanarak belirtilen dosya için 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 sınıfının yeni bir örneğini StreamWriter 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ı StreamWriter kullanarak belirtilen dosya için sınıfının yeni bir örneğini başlatır ve belirtilen FileStreamOptions nesneyle yapılandırılır.
StreamWriter(String, FileStreamOptions)	Varsayılan kodlamayı StreamWriter kullanarak belirtilen dosya için sınıfının yeni bir örneğini başlatır ve belirtilen FileStreamOptions nesneyle yapılandırılır.

Alanlar

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

Özellikler

AutoFlush	her çağrısından StreamWriterWrite(Char)sonra arabelleğinin temel alınan akışa boşaltılıp temizlenmeyeceğini belirten bir değer alır veya ayarlar.
BaseStream	Bir yedekleme deposu ile arabirim oluşturan temel akışı alır.
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 StreamWriter nesneyi 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)	Arabelleğe alınan verilerin temel alınan akışa yazılmasını sağlar, tarafından StreamWriterkullanı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 tarafından StreamWriterkullanı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()	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()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
Write(Boolean)	Bir Boolean değerin 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 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 bayt imzalı tamsayının metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(Int64)	8 bayt imzalı tamsayının metin gösterimini metin akışına yazar. (Devralındığı yer: TextWriter)
Write(Object)	Bir nesnenin metin gösterimini, bu nesne üzerinde yöntemini çağırarak metin akışına ToString 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)	Yöntemiyle aynı semantiği Format(String, Object) kullanarak akışa biçimlendirilmiş bir dize yazar.
Write(String, Object, Object)	Yöntemiyle aynı semantiği Format(String, Object, Object) kullanarak akışa biçimlendirilmiş bir dize yazar.
Write(String, Object, Object, Object)	Yöntemiyle aynı semantiği Format(String, Object, Object, Object) kullanarak akışa biçimlendirilmiş bir dize yazar.
Write(String, Object[])	Yöntemiyle aynı semantiği Format(String, Object[]) kullanarak akışa biçimlendirilmiş bir dize yazar.
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 bayt 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)	Akışa zaman uyumsuz olarak bir karakter alt dizisini 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ğ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 yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLine(Char[])	Metin akışına bir karakter dizisi yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLine(Char[], Int32, Int32)	Metin akışına bir karakter alt dizisi yazar ve ardından bir satır sonlandırıcısı 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ı yazar. (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ı yazar. (Devralındığı yer: TextWriter)
WriteLine(Int32)	4 bayt imzalı 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)	Metin akışına 8 bayt 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(Object)	Bir nesnenin metin gösterimini, bu nesne üzerinde yöntemini çağırarak ToString ve ardından bir satır sonlandırıcısı yazarak 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)	4 baytlık kayan nokta değerinin metin gösterimini metin akışına yazar ve ardından bir çizgi sonlandırıcısı yazar. (Devralındığı yer: TextWriter)
WriteLine(String)	Akışa bir dize yazar ve ardından bir satır sonlandırıcısı yazar.
WriteLine(String, Object)	Yöntemiyle aynı semantiği Format(String, Object) kullanarak akışa biçimlendirilmiş bir dize ve yeni bir satır yazar.
WriteLine(String, Object, Object)	Yöntemiyle aynı semantiği Format(String, Object, Object) kullanarak akışa biçimlendirilmiş bir dize ve yeni bir satır yazar.
WriteLine(String, Object, Object, Object)	ile aynı semantiği Format(String, Object)kullanarak akışa biçimlendirilmiş bir dize ve yeni bir satır yazar.
WriteLine(String, Object[])	ile aynı semantiği Format(String, Object)kullanarak akışa biçimlendirilmiş bir dize ve yeni bir satır yazar.
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)	Akışa zaman uyumsuz olarak bir karakter alt dizisini yazar ve ardından bir satır sonlandırıcısı 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ısı ekler.
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ştirildiğini yapılandıran.

Ayrıca bkz.

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