StreamWriter Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
[System.Serializable]
public class StreamWriter : System.IO.TextWriter
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class StreamWriter : System.IO.TextWriter
type StreamWriter = class
inherit TextWriter
[<System.Serializable>]
type StreamWriter = class
inherit TextWriter
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type StreamWriter = class
inherit TextWriter
Public Class StreamWriter
Inherits TextWriter
- Devralma
- Devralma
- Öznitelikler
Ö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 sonuna 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 sonuna 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 sonuna eklenebilir. Dosya yoksa, bu oluşturucu yeni bir dosya oluşturur. |
StreamWriter(String, Encoding, FileStreamOptions) |
Belirtilen dosya için belirtilen kodlamayı StreamWriter kullanarak 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 |
Null |
Yazılabilen ancak okunmayan yedekleme deposu olmayan bir |
Özellikler
AutoFlush |
her çağrısından Write(Char)sonra arabelleğinin temel akışa boşaltılıp temizlenmeyeceğini StreamWriter belirten bir değer alır veya ayarlar. |
BaseStream |
Bir yedekleme deposuyla 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 |
Yöntemler
Close() |
Geçerli |
Close() |
Geçerli yazıcıyı kapatır ve yazıcıyla ilişkili tüm sistem kaynaklarını serbest bırakır. (Devralındığı yer: TextWriter) |
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 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. |
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) |
Finalize() |
Atık toplayıcı tarafından geri kazanılmadan önce geçerli StreamWriter kaynakları serbest kalır. |
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 cihaza yazılmasına neden olur. |
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. (Devralındığı yer: TextWriter) |
FlushAsync(CancellationToken) |
Bu akış için tüm arabellekleri zaman uyumsuz olarak temizler ve arabelleğe alınan verilerin temel 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) |
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 |
Write(Char) |
Akışa bir karakter yazar. |
Write(Char[]) |
Akışa bir karakter dizisi yazar. |
Write(Char[], Int32, Int32) |
Akışa karakterlerden oluşan bir alt dizi 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 |
Write(ReadOnlySpan<Char>) |
Akışa bir karakter aralığı yazar. |
Write(ReadOnlySpan<Char>) |
Metin akışına bir karakter aralığı yazar. (Devralındığı yer: TextWriter) |
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) |
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 akışa biçimlendirilmiş bir dize yazar. |
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 akışa biçimlendirilmiş bir dize yazar. |
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 akışa biçimlendirilmiş 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(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 yazar. (Devralındığı yer: TextWriter) |
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 dizisi yazar. |
WriteAsync(Char[], Int32, Int32) |
Metin akışına zaman uyumsuz olarak bir karakter alt dizisi yazar. (Devralındığı yer: TextWriter) |
WriteAsync(ReadOnlyMemory<Char>, CancellationToken) |
Akışa zaman uyumsuz olarak bir karakter bellek bölgesi yazar. |
WriteAsync(ReadOnlyMemory<Char>, CancellationToken) |
Metin akışına zaman uyumsuz olarak bir karakter bellek bölgesi yazar. (Devralındığı yer: TextWriter) |
WriteAsync(String) |
Akışa zaman uyumsuz olarak bir dize yazar. |
WriteAsync(String) |
Metin akışına zaman uyumsuz olarak bir dize yazar. (Devralındığı yer: TextWriter) |
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 |
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 |
WriteLine(ReadOnlySpan<Char>) |
Bir karakter aralığının metin gösterimini akışa yazar ve ardından bir satır sonlandırıcısı ekler. |
WriteLine(ReadOnlySpan<Char>) |
Bir karakter aralığı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(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) |
Akışa bir dize ve ardından bir satır sonlandırıcı yazar. |
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 akışa biçimlendirilmiş bir dize ve yeni bir satır yazar. |
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 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 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 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 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 akışa biçimlendirilmiş bir dize ve yeni bir satır yazar. |
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) |
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() |
Zaman uyumsuz olarak metin akışına bir satır sonlandırıcı yazar. (Devralındığı yer: TextWriter) |
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 yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter) |
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 dizisi yazar ve ardından bir satır sonlandırıcısı ekler. |
WriteLineAsync(Char[], Int32, Int32) |
Zaman uyumsuz olarak metin akışına bir karakter alt dizisini yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter) |
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(ReadOnlyMemory<Char>, CancellationToken) |
Bir karakter bellek bölgesinin 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) |
WriteLineAsync(String) |
Zaman uyumsuz olarak akışa bir dize yazar ve ardından bir satır sonlandırıcısı ekler. |
WriteLineAsync(String) |
Zaman uyumsuz olarak metin akışına bir dize yazar ve ardından bir satır sonlandırıcısı yazar. (Devralındığı yer: TextWriter) |
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) |
Belirtik Arabirim Kullanımları
IDisposable.Dispose() |
Bu üyenin açıklaması için bkz Dispose(). . (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. |
Şunlara uygulanır
Ayrıca bkz.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin