StreamWriter Oluşturucular

Tanım

Ad Alanı:: System.IO

Bütünleştirilmiş Kodlar:: mscorlib.dll, System.IO.dll

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Runtime.dll

Bütünleştirilmiş Kod:: System.IO.dll

Bütünleştirilmiş Kod:: System.Runtime.Extensions.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Ö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

Name	Description
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 üzerine 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 ü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(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 üzerine eklenebilir. Dosya yoksa, bu oluşturucu yeni bir dosya oluşturur.

StreamWriter(Stream)

Kaynak:: StreamWriter.cs

Kaynak:: StreamWriter.cs

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.StreamWriter

Public Sub New (stream As Stream)

Parametreler

stream: Stream

Yazacak akış.

Özel durumlar

ArgumentException

stream yazılabilir değildir.

ArgumentNullException

stream, null'e eşittir.

Ö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 kodlaması GetPreamble içeren 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 atılıp atılmayacağını belirtmek için, bir 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.

StreamWriter nesnesi ç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ümesini 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)

Kaynak:: StreamWriter.cs

Kaynak:: StreamWriter.cs

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.StreamWriter

Public Sub New (path As String)

Parametreler

path: String

Yazacak tam dosya yolu. path bir dosya adı olabilir.

Özel durumlar

UnauthorizedAccessException

Erişim reddedildi.

ArgumentException

path boş bir dizedir ("").

-veya-

path bir sistem cihazının adını içerir (com1, com2 vb.).

ArgumentNullException

path, null'e eşittir.

DirectoryNotFoundException

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

IOException

path dosya adı, dizin adı veya birim etiketi söz dizimi için yanlış veya geçersiz bir söz dizimi içerir.

SecurityException

Ç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 kodlaması GetPreamble içeren 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şturup oluşturmadığı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

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

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);

public StreamWriter(System.IO.Stream stream, System.Text.Encoding? encoding);

new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding -> System.IO.StreamWriter

Public Sub New (stream As Stream, encoding As Encoding)

Parametreler

stream: Stream

Yazacak akış.

encoding: Encoding

Kullanılacak karakter kodlaması.

Özel durumlar

ArgumentNullException

stream veya encoding şeklindedir null.

ArgumentException

stream yazılabilir değildir.

Ö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 stream parametresini BaseStream kullanarak özelliğini başlatır. Akışın konumu sıfırlanmaz. Ek bilgi için bkz. Encoding.

StreamWriter nesnesi ç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.

Şunlara uygulanır

StreamWriter(String, Boolean)

Kaynak:: StreamWriter.cs

Kaynak:: StreamWriter.cs

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 üzerine 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.StreamWriter

Public 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 olmaz ve oluşturucu yeni bir dosya oluşturur.

Özel durumlar

UnauthorizedAccessException

Erişim reddedildi.

ArgumentException

path boş.

-veya-

path bir sistem cihazının adını içerir (com1, com2 vb.).

ArgumentNullException

path, null'e eşittir.

DirectoryNotFoundException

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

IOException

path dosya adı, dizin adı veya birim etiketi söz dizimi için yanlış veya geçersiz bir söz dizimi içerir.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

SecurityException

Ç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 kodlaması GetPreamble içeren 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şturup oluşturmadığı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

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

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.StreamWriter

Public 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

ArgumentNullException

options şeklindedir null .

ArgumentException

path yazılabilir değildir.

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(Stream, Encoding, Int32)

Kaynak:: StreamWriter.cs

Kaynak:: StreamWriter.cs

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);

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.StreamWriter

Public Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer)

Parametreler

stream: Stream

Yazacak akış.

encoding: Encoding

Kullanılacak karakter kodlaması.

bufferSize: Int32

Arabellek boyutu( karakter cinsinden).

Özel durumlar

ArgumentNullException

stream veya encoding şeklindedir null.

ArgumentOutOfRangeException

bufferSize , varsayılan arabellek boyutunu belirtmesine izin verilen -1 dışında sıfırdan küçük veya sıfıra eşittir.

ArgumentException

stream yazılabilir değildir.

Ö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. Ek bilgi için bkz. Encoding.

StreamWriter nesnesi çağrıldığında StreamWriter.Dispose sağlanan Stream nesnede çağrılırDispose().

Dikkat

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

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(String, Boolean, Encoding)

Kaynak:: StreamWriter.cs

Kaynak:: StreamWriter.cs

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 üzerine 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);

public StreamWriter(string path, bool append, System.Text.Encoding encoding);

new System.IO.StreamWriter : string * bool * System.Text.Encoding -> System.IO.StreamWriter

Public 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 olmaz ve oluşturucu yeni bir dosya oluşturur.

encoding: Encoding

Kullanılacak karakter kodlaması.

Özel durumlar

UnauthorizedAccessException

Erişim reddedildi.

ArgumentException

path boş.

-veya-

path bir sistem cihazının adını içerir (com1, com2 vb.).

ArgumentNullException

path, null'e eşittir.

DirectoryNotFoundException

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

IOException

path dosya adı, dizin adı veya birim etiketi söz dizimi için yanlış veya geçersiz bir söz dizimi içerir.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

SecurityException

Ç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. Ek 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ı gerekli değildir; akışlar aracılığıyla erişimi destekleyen bir sistemin herhangi bir parçası olabilir.

Dikkat

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

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(String, Encoding, FileStreamOptions)

Kaynak:: StreamWriter.cs

Kaynak:: StreamWriter.cs

Kaynak:: StreamWriter.cs

Kaynak:: StreamWriter.cs

Kaynak:: StreamWriter.cs

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.

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);

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.StreamWriter

Public 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

ArgumentNullException

options şeklindedir null .

ArgumentException

path yazılabilir değildir.

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(Stream, Encoding, Int32, Boolean)

Kaynak:: StreamWriter.cs

Kaynak:: StreamWriter.cs

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.StreamWriter

Public 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

Arabellek boyutu( karakter cinsinden).

leaveOpen: Boolean

true nesnesi atıldıktan sonra StreamWriter akışı açık bırakmak için; aksi takdirde , false.

Özel durumlar

ArgumentNullException

stream veya encoding şeklindedir null.

ArgumentOutOfRangeException

bufferSize , varsayılan arabellek boyutunu belirtmesine izin verilen -1 dışında sıfırdan küçük veya sıfıra eşittir.

ArgumentException

stream yazılabilir değildir.

Ö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 nesnede ç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

Şunlara uygulanır

StreamWriter(String, Boolean, Encoding, Int32)

Kaynak:: StreamWriter.cs

Kaynak:: StreamWriter.cs

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 üzerine 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);

public StreamWriter(string path, bool append, System.Text.Encoding encoding, int bufferSize);

new System.IO.StreamWriter : string * bool * System.Text.Encoding * int -> System.IO.StreamWriter

Public 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 olmaz ve oluşturucu yeni bir dosya oluşturur.

encoding: Encoding

Kullanılacak karakter kodlaması.

bufferSize: Int32

Arabellek boyutu( karakter cinsinden).

Özel durumlar

ArgumentException

path boş bir dizedir ("").

-veya-

path bir sistem cihazının adını içerir (com1, com2 vb.).

ArgumentNullException

path veya encoding şeklindedir null.

ArgumentOutOfRangeException

bufferSize , varsayılan arabellek boyutunu belirtmesine izin verilen -1 dışında sıfırdan küçük veya sıfıra eşittir.

IOException

path dosya adı, dizin adı veya birim etiketi söz dizimi için yanlış veya geçersiz bir söz dizimi içerir.

SecurityException

Çağıranın gerekli izni yok.

UnauthorizedAccessException

Erişim reddedildi.

DirectoryNotFoundException

Belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını 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. Ek 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ı gerekli değildir; akışlar aracılığıyla erişimi destekleyen bir sistemin herhangi bir parçası olabilir.

Dikkat

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

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Aracılığıyla paylaş

StreamWriter Oluşturucular

Tanım

Aşırı Yüklemeler

StreamWriter(Stream)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(String)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(Stream, Encoding)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(String, Boolean)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(String, FileStreamOptions)

Parametreler

Özel durumlar

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(Stream, Encoding, Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(String, Boolean, Encoding)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(String, Encoding, FileStreamOptions)

Parametreler

Özel durumlar

Ayrıca bkz.

Şunlara uygulanır

StreamWriter(Stream, Encoding, Int32, Boolean)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

StreamWriter(String, Boolean, Encoding, Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim