StreamWriter Oluşturucular

  • Başvuru

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kod:
System.IO.dll
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
System.Runtime.Extensions.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

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.StreamWriter
Public Sub New (stream As Stream)

Parametreler

stream
Stream

Yazacak akış.

Özel durumlar

ArgumentException

stream yazılabilir değil.

ArgumentNullException

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.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 değeridir.

DirectoryNotFoundException

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

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu 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 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.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ğ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.

Ş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.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 yoktur 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 değeridir.

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 birden sistem tarafından tanımlanan en fazla uzunluğu 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 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.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

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

Bayt cinsinden arabellek boyutu.

Özel durumlar

ArgumentNullException

stream veya encoding şeklindedir null.

ArgumentOutOfRangeException

bufferSize negatiftir.

ArgumentException

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.

Ş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.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 yoktur 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 değeridir.

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 birden sistem tarafından tanımlanan en fazla uzunluğu 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. 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.

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

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

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

ArgumentNullException

stream veya encoding şeklindedir null.

ArgumentOutOfRangeException

bufferSize negatiftir.

ArgumentException

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

encoding
Encoding

Kullanılacak karakter kodlaması.

bufferSize
Int32

Bayt cinsinden arabellek boyutu.

Ö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 negatiftir.

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

Şunlara uygulanır