StreamWriter Oluşturucular
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.
StreamWriter sınıfının yeni bir örneğini başlatır.
Aşırı Yüklemeler
| 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(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(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(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, 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. |
| 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(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, 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(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, 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(Stream)
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
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.
public:
StreamWriter(System::IO::Stream ^ stream);public StreamWriter (System.IO.Stream stream);new System.IO.StreamWriter : System.IO.Stream -> System.IO.StreamWriterPublic Sub New (stream As Stream)Parametreler
- stream
- Stream
Yazacak akış.
Özel durumlar
stream yazılabilir değil.
stream, null değeridir.
Örnekler
Aşağıdaki kod örneği bu oluşturucuyu gösterir.
using System;
using System.IO;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Açıklamalar
Bu oluşturucu, Byte-Order İşareti (BOM) olmadan UTF-8 kodlamalı GetPreamble bir oluştururStreamWriter, bu nedenle 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. Geçersiz baytlarda bir özel durumun oluşturulup oluşturulmayacağını belirtmek için, kodlama nesnesini parametre olarak kabul eden bir oluşturucu kullanın, örneğin StreamWriter. BaseStream özelliği parametresi kullanılarak stream başlatılır. Akışın konumu sıfırlanmaz.
nesnesi StreamWriter çağrıldığında StreamWriter.Dispose sağlanan Stream nesnede çağrılırDispose().
Dikkat
Bir karakter kümesini belirli bir kültürel ayarla derlediğiniz zaman ve bu aynı karakterleri farklı kültürel ayarla aldığınızda, karakterler yorumlanabilir olmayabilir ve bir özel durum oluşturulmasına neden olabilir.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
Şunlara uygulanır
StreamWriter(String)
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
Varsayılan kodlama ve arabellek boyutunu kullanarak belirtilen dosya için sınıfının yeni bir örneğini StreamWriter başlatır.
public:
StreamWriter(System::String ^ path);public StreamWriter (string path);new System.IO.StreamWriter : string -> System.IO.StreamWriterPublic Sub New (path As String)Parametreler
- path
- String
Yazacak tam dosya yolu. path bir dosya adı olabilir.
Özel durumlar
Erişim reddedildi.
path boş bir dizedir ("").
-veya-
path bir sistem cihazının adını içerir (com1, com2 vb.).
path, null değeridir.
Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).
Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.
path dosya adı, dizin adı veya birim etiketi söz dizimi için yanlış veya geçersiz bir söz dizimi içerir.
Çağıranın gerekli izni yok.
Örnekler
Aşağıdaki kod örneği bu oluşturucuyu gösterir.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName)
writer.Write(textToAdd)
End Using
End Sub
End Module
Açıklamalar
Bu oluşturucu, Byte-Order İşareti (BOM) olmadan UTF-8 kodlamalı GetPreamble bir oluştururStreamWriter, bu nedenle 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. Bir BOM belirtmek ve geçersiz baytlarda özel durum oluşturulup oluşturulmayacağını belirlemek için, bir kodlama nesnesini parametre olarak kabul eden bir oluşturucu kullanın, örneğin StreamWriter(String, Boolean, Encoding).
path Parametresi, Evrensel Adlandırma Kuralı (UNC) paylaşımındaki bir dosya da dahil olmak üzere bir dosya adı olabilir. Dosya varsa üzerine yazılır; aksi takdirde yeni bir dosya oluşturulur.
parametresinin path diskte depolanan bir dosya olması gerekmez; akışları kullanarak erişimi destekleyen bir sistemin herhangi bir parçası olabilir.
Dikkat
Bir karakter kümesini belirli bir kültürel ayarla derlediğiniz zaman ve bu aynı karakterleri farklı kültürel ayarla aldığınızda, karakterler yorumlanabilir olmayabilir ve bir özel durum oluşturulmasına neden olabilir.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
Şunlara uygulanır
StreamWriter(Stream, Encoding)
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
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.
public:
StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding);public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding);new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding -> System.IO.StreamWriterPublic Sub New (stream As Stream, encoding As Encoding)Parametreler
- stream
- Stream
Yazacak akış.
- encoding
- Encoding
Kullanılacak karakter kodlaması.
Özel durumlar
stream veya encoding şeklindedir null.
stream yazılabilir değil.
Örnekler
Aşağıdaki örnekte bu oluşturucu gösterilmektedir.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs, Encoding.Default))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Açıklamalar
Bu oluşturucu, kodlama parametresini Encoding kullanarak özelliğini ve akış parametresini BaseStream kullanarak özelliğini başlatır. Akışın konumu sıfırlanmaz. Daha fazla bilgi için, bkz. Encoding.
nesnesi StreamWriter çağrıldığında StreamWriter.Dispose sağlanan Stream nesnede çağrılırDispose().
Dikkat
Belirli bir kültürel ayara sahip bir karakter kümesi derleyip aynı karakterleri farklı bir kültürel ayarla aldığınızda, karakterler yorumlanamayabilir ve bir özel durumun oluşturulmasına neden olabilir.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- Encoding
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
StreamWriter(String, Boolean)
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
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.
public:
StreamWriter(System::String ^ path, bool append);public StreamWriter (string path, bool append);new System.IO.StreamWriter : string * bool -> System.IO.StreamWriterPublic Sub New (path As String, append As Boolean)Parametreler
- path
- String
Yazacak tam dosya yolu.
- append
- Boolean
true dosyaya veri eklemek için; false dosyasının üzerine yazılmasını sağlayın. Belirtilen dosya yoksa, bu parametrenin hiçbir etkisi yoktur ve oluşturucu yeni bir dosya oluşturur.
Özel durumlar
Erişim reddedildi.
path, null değeridir.
Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).
path dosya adı, dizin adı veya birim etiketi söz dizimi için yanlış veya geçersiz bir söz dizimi içerir.
Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.
Çağıranın gerekli izni yok.
Örnekler
Aşağıdaki kod örneği bu oluşturucuyu gösterir.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName, true))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName, True)
writer.Write(textToAdd)
End Using
End Sub
End Module
Açıklamalar
Bu oluşturucu, Byte-Order İşareti (BOM) olmadan UTF-8 kodlamalı GetPreamble bir oluştururStreamWriter, bu nedenle 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. Bir BOM belirtmek ve geçersiz baytlarda özel durum oluşturulup oluşturulmayacağını belirlemek için, bir kodlama nesnesini parametre olarak kabul eden bir oluşturucu kullanın, örneğin StreamWriter(String, Boolean, Encoding).
path Parametresi, Evrensel Adlandırma Kuralı (UNC) paylaşımındaki bir dosya da dahil olmak üzere bir dosya adı olabilir.
parametresinin path diskte depolanan bir dosya olması gerekmez; akışları kullanarak erişimi destekleyen bir sistemin herhangi bir parçası olabilir.
Dikkat
Belirli bir kültürel ayara sahip bir karakter kümesi derleyip aynı karakterleri farklı bir kültürel ayarla aldığınızda, karakterler yorumlanamayabilir ve bir özel durumun oluşturulmasına neden olabilir.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
Şunlara uygulanır
StreamWriter(String, FileStreamOptions)
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
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.
public:
StreamWriter(System::String ^ path, System::IO::FileStreamOptions ^ options);public StreamWriter (string path, System.IO.FileStreamOptions options);new System.IO.StreamWriter : string * System.IO.FileStreamOptions -> System.IO.StreamWriterPublic Sub New (path As String, options As FileStreamOptions)Parametreler
- path
- String
Yazacak tam dosya yolu.
- options
- FileStreamOptions
Temel alınan FileStreamiçin yapılandırma seçeneklerini belirten bir nesne.
Özel durumlar
options şeklindedir null .
stream yazılabilir değil.
Ayrıca bkz.
Şunlara uygulanır
StreamWriter(Stream, Encoding, Int32)
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
Belirtilen kodlama ve arabellek boyutunu kullanarak belirtilen akış için sınıfının yeni bir örneğini StreamWriter başlatır.
public:
StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, int bufferSize);public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding, int bufferSize);new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int -> System.IO.StreamWriterPublic Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer)Parametreler
- stream
- Stream
Yazacak akış.
- encoding
- Encoding
Kullanılacak karakter kodlaması.
- bufferSize
- Int32
Bayt cinsinden arabellek boyutu.
Özel durumlar
stream veya encoding şeklindedir null.
bufferSize negatiftir.
stream yazılabilir değil.
Örnekler
Aşağıdaki örnekte bu oluşturucu gösterilmektedir.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs, Encoding.UTF8, 512))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default, 512)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Açıklamalar
Bu oluşturucu parametresini Encoding kullanarak encoding özelliğini ve parametresini BaseStreamstream kullanarak özelliğini başlatır. Akışın konumu sıfırlanmaz. Daha fazla bilgi için, bkz. Encoding.
nesnesi StreamWriter çağrıldığında StreamWriter.Dispose sağlanan Stream nesnede çağrılırDispose().
Dikkat
Belirli bir kültürel ayara sahip bir karakter kümesi derleyip aynı karakterleri farklı bir kültürel ayarla aldığınızda, karakterler yorumlanamayabilir ve bir özel durumun oluşturulmasına neden olabilir.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- Encoding
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
StreamWriter(String, Boolean, Encoding)
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
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.
public:
StreamWriter(System::String ^ path, bool append, System::Text::Encoding ^ encoding);public StreamWriter (string path, bool append, System.Text.Encoding encoding);new System.IO.StreamWriter : string * bool * System.Text.Encoding -> System.IO.StreamWriterPublic Sub New (path As String, append As Boolean, encoding As Encoding)Parametreler
- path
- String
Yazacak tam dosya yolu.
- append
- Boolean
true dosyaya veri eklemek için; false dosyasının üzerine yazılmasını sağlayın. Belirtilen dosya yoksa, bu parametrenin hiçbir etkisi yoktur ve oluşturucu yeni bir dosya oluşturur.
- encoding
- Encoding
Kullanılacak karakter kodlaması.
Özel durumlar
Erişim reddedildi.
path, null değeridir.
Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).
path dosya adı, dizin adı veya birim etiketi söz dizimi için yanlış veya geçersiz bir söz dizimi içerir.
Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.
Çağıranın gerekli izni yok.
Örnekler
Aşağıdaki örnekte bu oluşturucu gösterilmektedir.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName, true, Encoding.UTF8))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName, True, Encoding.UTF8)
writer.Write(textToAdd)
End Using
End Sub
End Module
Açıklamalar
Bu oluşturucu, kodlama parametresini Encoding kullanarak özelliğini başlatır. Daha fazla bilgi için, bkz. Encoding.
path , Evrensel Adlandırma Kuralı (UNC) paylaşımındaki bir dosya da dahil olmak üzere bir dosya adı olabilir.
path diskte depolanan bir dosya olması gerekmez; akışlar aracılığıyla erişimi destekleyen bir sistemin herhangi bir parçası olabilir.
Dikkat
Belirli bir kültürel ayara sahip bir karakter kümesi derleyip aynı karakterleri farklı bir kültürel ayarla aldığınızda, karakterler yorumlanamayabilir ve bir özel durumun oluşturulmasına neden olabilir.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- Encoding
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
StreamWriter(String, Encoding, FileStreamOptions)
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
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.
public:
StreamWriter(System::String ^ path, System::Text::Encoding ^ encoding, System::IO::FileStreamOptions ^ options);public StreamWriter (string path, System.Text.Encoding encoding, System.IO.FileStreamOptions options);new System.IO.StreamWriter : string * System.Text.Encoding * System.IO.FileStreamOptions -> System.IO.StreamWriterPublic Sub New (path As String, encoding As Encoding, options As FileStreamOptions)Parametreler
- path
- String
Yazacak tam dosya yolu.
- encoding
- Encoding
Kullanılacak karakter kodlaması.
- options
- FileStreamOptions
Temel alınan FileStreamiçin yapılandırma seçeneklerini belirten bir nesne.
Özel durumlar
options şeklindedir null .
stream yazılabilir değil.
Ayrıca bkz.
Şunlara uygulanır
StreamWriter(Stream, Encoding, Int32, Boolean)
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
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.
public:
StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, int bufferSize, bool leaveOpen);public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding, int bufferSize, bool leaveOpen);public StreamWriter (System.IO.Stream stream, System.Text.Encoding? encoding = default, int bufferSize = -1, bool leaveOpen = false);new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int * bool -> System.IO.StreamWriterPublic Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer, leaveOpen As Boolean)Public Sub New (stream As Stream, Optional encoding As Encoding = Nothing, Optional bufferSize As Integer = -1, Optional leaveOpen As Boolean = false)Parametreler
- stream
- Stream
Yazacak akış.
- encoding
- Encoding
Kullanılacak karakter kodlaması.
- bufferSize
- Int32
Bayt cinsinden arabellek boyutu.
- leaveOpen
- Boolean
true nesnesi atıldıktan sonra StreamWriter akışı açık bırakmak için; aksi takdirde , false.
Özel durumlar
stream veya encoding şeklindedir null.
bufferSize negatiftir.
stream yazılabilir değil.
Örnekler
Aşağıdaki örnekte bu oluşturucu gösterilmektedir.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
FileStream fs = null;
try
{
fs = new FileStream(fileName, FileMode.CreateNew);
using (StreamWriter writer = new StreamWriter(fs, Encoding.UTF8, 512, false))
{
writer.Write(textToAdd);
}
}
finally
{
if (fs != null)
fs.Dispose();
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Dim fs As FileStream = Nothing
Try
fs = New FileStream(fileName, FileMode.CreateNew)
Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default, 512, False)
writer.Write(textToAdd)
End Using
Finally
If Not fs Is Nothing Then
fs.Dispose()
End If
End Try
End Sub
End Module
Açıklamalar
parametresini leaveOpentrueStreamWriter olarak ayarlamadığınız sürece, nesne çağrıldığında StreamWriter.Dispose sağlanan Stream nesne üzerinde çağrılır.Dispose()
Bu oluşturucu parametresini Encoding kullanarak encoding özelliğini başlatır ve parametresini BaseStreamstream kullanarak özelliğini başlatır. Akışın konumu sıfırlanmaz. Daha fazla bilgi için özelliğine Encoding bakın.
Dikkat
Belirli bir kültürel ayara sahip bir karakter kümesi derleyip aynı karakterleri farklı bir kültürel ayarla aldığınızda, karakterler yorumlanamayabilir ve bir özel durumun oluşturulmasına neden olabilir.
Şunlara uygulanır
StreamWriter(String, Boolean, Encoding, Int32)
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
- Kaynak:
- StreamWriter.cs
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.
public:
StreamWriter(System::String ^ path, bool append, System::Text::Encoding ^ encoding, int bufferSize);public StreamWriter (string path, bool append, System.Text.Encoding encoding, int bufferSize);new System.IO.StreamWriter : string * bool * System.Text.Encoding * int -> System.IO.StreamWriterPublic Sub New (path As String, append As Boolean, encoding As Encoding, bufferSize As Integer)Parametreler
- path
- String
Yazacak tam dosya yolu.
- append
- Boolean
true dosyaya veri eklemek için; false dosyasının üzerine yazılmasını sağlayın. Belirtilen dosya yoksa, bu parametrenin hiçbir etkisi yoktur ve oluşturucu yeni bir dosya oluşturur.
- encoding
- Encoding
Kullanılacak karakter kodlaması.
- bufferSize
- Int32
Bayt cinsinden arabellek boyutu.
Özel durumlar
path boş bir dizedir ("").
-veya-
path bir sistem cihazının adını içerir (com1, com2 vb.).
path veya encoding şeklindedir null.
bufferSize negatiftir.
path dosya adı, dizin adı veya birim etiketi söz dizimi için yanlış veya geçersiz bir söz dizimi içerir.
Çağıranın gerekli izni yok.
Erişim reddedildi.
Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).
Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.
Örnekler
Aşağıdaki örnekte bu oluşturucu gösterilmektedir.
using System;
using System.IO;
using System.Text;
namespace ConsoleApplication
{
class Program
{
static void Main(string[] args)
{
string fileName = "test.txt";
string textToAdd = "Example text in file";
using (StreamWriter writer = new StreamWriter(fileName, true, Encoding.UTF8, 512))
{
writer.Write(textToAdd);
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
Dim fileName As String = "test.txt"
Dim textToAdd As String = "Example text in file"
Using writer As StreamWriter = New StreamWriter(fileName, True, Encoding.UTF8, 512)
writer.Write(textToAdd)
End Using
End Sub
End Module
Açıklamalar
Bu oluşturucu, kodlama parametresini Encoding kullanarak özelliğini başlatır. Daha fazla bilgi için, bkz. Encoding.
path , Evrensel Adlandırma Kuralı (UNC) paylaşımındaki bir dosya da dahil olmak üzere bir dosya adı olabilir.
path diskte depolanan bir dosya olması gerekmez; akışlar aracılığıyla erişimi destekleyen bir sistemin herhangi bir parçası olabilir.
Dikkat
Belirli bir kültürel ayara sahip bir karakter kümesi derleyip aynı karakterleri farklı bir kültürel ayarla aldığınızda, karakterler yorumlanamayabilir ve bir özel durumun oluşturulmasına neden olabilir.
Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.
Ayrıca bkz.
- Encoding
- Dosya ve Stream G/Ç
- Nasıl yapılır: Dosyadan Metin Okuma
- Nasıl yapılır: Bir Dosyaya Metin Yazma
Şunlara uygulanır
Geri Bildirim
Ç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. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin