StreamWriter Konstruktor

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Menginisialisasi instans baru kelas StreamWriter.

Overload

StreamWriter(Stream)	Menginisialisasi instans StreamWriter baru kelas untuk aliran yang ditentukan dengan menggunakan pengodean UTF-8 dan ukuran buffer default.
StreamWriter(String)	Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan dengan menggunakan pengodean default dan ukuran buffer.
StreamWriter(Stream, Encoding)	Menginisialisasi instans StreamWriter baru kelas untuk aliran yang ditentukan dengan menggunakan pengodean yang ditentukan dan ukuran buffer default.
StreamWriter(String, Boolean)	Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan dengan menggunakan pengodean default dan ukuran buffer. Jika ada, file dapat ditimpa atau ditambahkan. Jika file tidak ada, konstruktor ini membuat file baru.
StreamWriter(String, FileStreamOptions)	Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan, menggunakan pengodean default, dan dikonfigurasi dengan objek yang ditentukan FileStreamOptions .
StreamWriter(Stream, Encoding, Int32)	Menginisialisasi instans StreamWriter baru kelas untuk aliran yang ditentukan dengan menggunakan pengodean dan ukuran buffer yang ditentukan.
StreamWriter(String, Boolean, Encoding)	Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan dengan menggunakan pengodean yang ditentukan dan ukuran buffer default. Jika ada, file dapat ditimpa atau ditambahkan. Jika file tidak ada, konstruktor ini membuat file baru.
StreamWriter(String, Encoding, FileStreamOptions)	Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan, menggunakan pengodean yang ditentukan, dan dikonfigurasi dengan objek yang ditentukan FileStreamOptions .
StreamWriter(Stream, Encoding, Int32, Boolean)	Menginisialisasi instans StreamWriter baru kelas untuk aliran yang ditentukan dengan menggunakan ukuran pengodean dan buffer yang ditentukan, dan secara opsional membiarkan aliran terbuka.
StreamWriter(String, Boolean, Encoding, Int32)	Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan pada jalur yang ditentukan, menggunakan pengodean dan ukuran buffer yang ditentukan. Jika ada, file dapat ditimpa atau ditambahkan. Jika file tidak ada, konstruktor ini membuat file baru.

StreamWriter(Stream)

Sumber:

StreamWriter.cs

Menginisialisasi instans StreamWriter baru kelas untuk aliran yang ditentukan dengan menggunakan pengodean UTF-8 dan ukuran buffer default.

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)

Parameter

stream

Stream

Aliran yang akan ditulis.

Pengecualian

ArgumentException

stream tidak dapat ditulis.

ArgumentNullException

streamadalah null.

Contoh

Contoh kode berikut menunjukkan konstruktor ini.

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

Keterangan

Konstruktor ini membuat StreamWriter dengan pengodean UTF-8 tanpa tanda Byte-Order (BOM), sehingga metodenya GetPreamble mengembalikan array byte kosong. Pengodean UTF-8 default untuk konstruktor ini memberikan pengecualian pada byte yang tidak valid. Perilaku ini berbeda dari perilaku yang disediakan oleh objek pengodean di Encoding.UTF8 properti . Untuk menentukan apakah pengecualian dilemparkan pada byte yang tidak valid, gunakan konstruktor yang menerima objek pengodean sebagai parameter, seperti StreamWriter. Properti BaseStream diinisialisasi menggunakan stream parameter . Posisi aliran tidak direset.

Objek StreamWriter memanggil Dispose() pada objek yang disediakan Stream saat StreamWriter.Dispose dipanggil.

Perhatian

Ketika Anda mengkompilasi sekumpulan karakter dengan pengaturan budaya tertentu dan mengambil karakter yang sama dengan pengaturan budaya yang berbeda, karakter mungkin tidak dapat ditafsirkan dan dapat menyebabkan pengecualian dilemparkan.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

StreamWriter(String)

Sumber:

StreamWriter.cs

Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan dengan menggunakan pengodean default dan ukuran buffer.

public:
 StreamWriter(System::String ^ path);

public StreamWriter (string path);

new System.IO.StreamWriter : string -> System.IO.StreamWriter

Public Sub New (path As String)

Parameter

path

String

Jalur file lengkap untuk ditulis. path bisa berupa nama file.

Pengecualian

UnauthorizedAccessException

Akses ditolak.

ArgumentException

path adalah string kosong ("").

-atau-

path berisi nama perangkat sistem (com1, com2, dan sebagainya).

ArgumentNullException

pathadalah null.

DirectoryNotFoundException

Jalur yang ditentukan tidak valid (misalnya, jalur tersebut berada pada drive yang tidak dipetakan).

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

IOException

path menyertakan sintaksis yang salah atau tidak valid untuk nama file, nama direktori, atau sintaks label volume.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

Contoh

Contoh kode berikut menunjukkan konstruktor ini.

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

Keterangan

Konstruktor ini membuat StreamWriter dengan pengodean UTF-8 tanpa tanda Byte-Order (BOM), sehingga metodenya GetPreamble mengembalikan array byte kosong. Pengodean UTF-8 default untuk konstruktor ini memberikan pengecualian pada byte yang tidak valid. Perilaku ini berbeda dari perilaku yang disediakan oleh objek pengodean di Encoding.UTF8 properti . Untuk menentukan BOM dan menentukan apakah pengecualian dilemparkan pada byte yang tidak valid, gunakan konstruktor yang menerima objek pengodean sebagai parameter, seperti StreamWriter(String, Boolean, Encoding).

Parameter path dapat berupa nama file, termasuk file pada berbagi Universal Naming Convention (UNC). Jika file ada, file akan ditimpa; jika tidak, file baru dibuat.

Parameter path tidak diperlukan untuk menjadi file yang disimpan di disk; itu bisa menjadi bagian mana pun dari sistem yang mendukung akses menggunakan aliran.

Perhatian

Ketika Anda mengkompilasi sekumpulan karakter dengan pengaturan budaya tertentu dan mengambil karakter yang sama dengan pengaturan budaya yang berbeda, karakter mungkin tidak dapat ditafsirkan dan dapat menyebabkan pengecualian dilemparkan.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

StreamWriter(Stream, Encoding)

Sumber:

StreamWriter.cs

Menginisialisasi instans StreamWriter baru kelas untuk aliran yang ditentukan dengan menggunakan pengodean yang ditentukan dan ukuran buffer default.

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)

Parameter

stream

Stream

Aliran yang akan ditulis.

encoding

Encoding

Pengodean karakter yang akan digunakan.

Pengecualian

ArgumentNullException

stream atau encoding adalah null.

ArgumentException

stream tidak dapat ditulis.

Contoh

Contoh berikut menunjukkan konstruktor ini.

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

Keterangan

Konstruktor ini menginisialisasi Encoding properti menggunakan parameter pengodean, dan BaseStream properti menggunakan parameter stream. Posisi aliran tidak direset. Untuk informasi tambahan, lihat Encoding.

Objek StreamWriter memanggil Dispose() pada objek yang disediakan Stream saat StreamWriter.Dispose dipanggil.

Perhatian

Ketika Anda mengkompilasi sekumpulan karakter dengan pengaturan budaya tertentu dan mengambil karakter yang sama dengan pengaturan budaya yang berbeda, karakter mungkin tidak dapat ditafsirkan, dan dapat menyebabkan pengecualian dilemparkan.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• Encoding
• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

StreamWriter(String, Boolean)

Sumber:

StreamWriter.cs

Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan dengan menggunakan pengodean default dan ukuran buffer. Jika ada, file dapat ditimpa atau ditambahkan. Jika file tidak ada, konstruktor ini membuat file baru.

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)

Parameter

path

String

Jalur file lengkap untuk ditulis.

append

Boolean

true untuk menambahkan data ke file; false untuk menimpa file. Jika file yang ditentukan tidak ada, parameter ini tidak berpengaruh, dan konstruktor membuat file baru.

Pengecualian

UnauthorizedAccessException

Akses ditolak.

ArgumentException

path kosong.

-atau-

path berisi nama perangkat sistem (com1, com2, dan sebagainya).

ArgumentNullException

pathadalah null.

DirectoryNotFoundException

Jalur yang ditentukan tidak valid (misalnya, jalur tersebut berada pada drive yang tidak dipetakan).

IOException

path menyertakan sintaksis yang salah atau tidak valid untuk nama file, nama direktori, atau sintaks label volume.

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

Contoh

Contoh kode berikut menunjukkan konstruktor ini.

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

Keterangan

Konstruktor ini membuat StreamWriter dengan pengodean UTF-8 tanpa tanda Byte-Order (BOM), sehingga metodenya GetPreamble mengembalikan array byte kosong. Pengodean UTF-8 default untuk konstruktor ini memberikan pengecualian pada byte yang tidak valid. Perilaku ini berbeda dari perilaku yang disediakan oleh objek pengodean di Encoding.UTF8 properti . Untuk menentukan BOM dan menentukan apakah pengecualian dilemparkan pada byte yang tidak valid, gunakan konstruktor yang menerima objek pengodean sebagai parameter, seperti StreamWriter(String, Boolean, Encoding).

Parameter path dapat berupa nama file, termasuk file pada berbagi Universal Naming Convention (UNC).

Parameter path tidak diperlukan untuk menjadi file yang disimpan di disk; itu bisa menjadi bagian mana pun dari sistem yang mendukung akses menggunakan aliran.

Perhatian

Ketika Anda mengkompilasi sekumpulan karakter dengan pengaturan budaya tertentu dan mengambil karakter yang sama dengan pengaturan budaya yang berbeda, karakter mungkin tidak dapat ditafsirkan, dan dapat menyebabkan pengecualian dilemparkan.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

StreamWriter(String, FileStreamOptions)

Sumber:

StreamWriter.cs

Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan, menggunakan pengodean default, dan dikonfigurasi dengan objek yang ditentukan FileStreamOptions .

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)

Parameter

path

String

Jalur file lengkap untuk ditulis.

options

FileStreamOptions

Objek yang menentukan opsi konfigurasi untuk yang mendasar FileStream.

Pengecualian

ArgumentNullException

options adalah null .

ArgumentException

stream tidak dapat ditulis.

Lihat juga

• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

StreamWriter(Stream, Encoding, Int32)

Sumber:

StreamWriter.cs

Menginisialisasi instans StreamWriter baru kelas untuk aliran yang ditentukan dengan menggunakan pengodean dan ukuran buffer yang ditentukan.

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)

Parameter

stream

Stream

Aliran yang akan ditulis.

encoding

Encoding

Pengodean karakter yang akan digunakan.

bufferSize

Int32

Ukuran buffer, dalam byte.

Pengecualian

ArgumentNullException

stream atau encoding adalah null.

ArgumentOutOfRangeException

bufferSize negatif.

ArgumentException

stream tidak dapat ditulis.

Contoh

Contoh berikut menunjukkan konstruktor ini.

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

Keterangan

Konstruktor ini menginisialisasi Encoding properti menggunakan encoding parameter , dan BaseStream properti menggunakan stream parameter . Posisi aliran tidak direset. Untuk informasi tambahan, lihat Encoding.

Objek StreamWriter memanggil Dispose() pada objek yang disediakan Stream saat StreamWriter.Dispose dipanggil.

Perhatian

Ketika Anda mengkompilasi sekumpulan karakter dengan pengaturan budaya tertentu dan mengambil karakter yang sama dengan pengaturan budaya yang berbeda, karakter mungkin tidak dapat ditafsirkan, dan dapat menyebabkan pengecualian dilemparkan.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• Encoding
• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

StreamWriter(String, Boolean, Encoding)

Sumber:

StreamWriter.cs

Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan dengan menggunakan pengodean yang ditentukan dan ukuran buffer default. Jika ada, file dapat ditimpa atau ditambahkan. Jika file tidak ada, konstruktor ini membuat file baru.

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)

Parameter

path

String

Jalur file lengkap untuk ditulis.

append

Boolean

true untuk menambahkan data ke file; false untuk menimpa file. Jika file yang ditentukan tidak ada, parameter ini tidak berpengaruh, dan konstruktor membuat file baru.

encoding

Encoding

Pengodean karakter yang akan digunakan.

Pengecualian

UnauthorizedAccessException

Akses ditolak.

ArgumentException

path kosong.

-atau-

path berisi nama perangkat sistem (com1, com2, dan sebagainya).

ArgumentNullException

pathadalah null.

DirectoryNotFoundException

Jalur yang ditentukan tidak valid (misalnya, jalur tersebut berada pada drive yang tidak dipetakan).

IOException

path menyertakan sintaksis yang salah atau tidak valid untuk nama file, nama direktori, atau sintaks label volume.

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

Contoh

Contoh berikut menunjukkan konstruktor ini.

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

Keterangan

Konstruktor ini menginisialisasi Encoding properti menggunakan parameter pengodean. Untuk informasi tambahan, lihat Encoding.

path dapat berupa nama file, termasuk file pada berbagi Universal Naming Convention (UNC).

path tidak diperlukan untuk menjadi file yang disimpan pada disk; ini dapat menjadi bagian mana pun dari sistem yang mendukung akses melalui aliran.

Perhatian

Ketika Anda mengkompilasi sekumpulan karakter dengan pengaturan budaya tertentu dan mengambil karakter yang sama dengan pengaturan budaya yang berbeda, karakter mungkin tidak dapat ditafsirkan, dan dapat menyebabkan pengecualian dilemparkan.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• Encoding
• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

StreamWriter(String, Encoding, FileStreamOptions)

Sumber:

StreamWriter.cs

Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan, menggunakan pengodean yang ditentukan, dan dikonfigurasi dengan objek yang ditentukan FileStreamOptions .

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)

Parameter

path

String

Jalur file lengkap untuk ditulis.

encoding

Encoding

Pengodean karakter yang akan digunakan.

options

FileStreamOptions

Objek yang menentukan opsi konfigurasi untuk yang mendasar FileStream.

Pengecualian

ArgumentNullException

options adalah null .

ArgumentException

stream tidak dapat ditulis.

Lihat juga

• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

StreamWriter(Stream, Encoding, Int32, Boolean)

Sumber:

StreamWriter.cs

Menginisialisasi instans StreamWriter baru kelas untuk aliran yang ditentukan dengan menggunakan ukuran pengodean dan buffer yang ditentukan, dan secara opsional membiarkan aliran terbuka.

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, Optional encoding As Encoding = Nothing, Optional bufferSize As Integer = -1, Optional leaveOpen As Boolean = false)

Parameter

stream

Stream

Aliran yang akan ditulis.

encoding

Encoding

Pengodean karakter yang akan digunakan.

bufferSize

Int32

Ukuran buffer, dalam byte.

leaveOpen

Boolean

true untuk membiarkan aliran terbuka setelah StreamWriter objek dibuang; jika tidak, false.

Pengecualian

ArgumentNullException

stream atau encoding adalah null.

ArgumentOutOfRangeException

bufferSize negatif.

ArgumentException

stream tidak dapat ditulis.

Contoh

Contoh berikut menunjukkan konstruktor ini.

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

Keterangan

Kecuali Anda mengatur leaveOpen parameter ke true, StreamWriter objek memanggil Dispose() pada objek yang disediakan Stream saat StreamWriter.Dispose dipanggil.

Konstruktor ini menginisialisasi Encoding properti dengan menggunakan encoding parameter , dan menginisialisasi BaseStream properti dengan menggunakan stream parameter . Posisi aliran tidak direset. Untuk informasi tambahan, lihat Encoding properti .

Perhatian

Ketika Anda mengkompilasi sekumpulan karakter dengan pengaturan budaya tertentu dan mengambil karakter yang sama dengan pengaturan budaya yang berbeda, karakter mungkin tidak dapat ditafsirkan, dan dapat menyebabkan pengecualian dilemparkan.

StreamWriter(String, Boolean, Encoding, Int32)

Sumber:

StreamWriter.cs

Menginisialisasi instans StreamWriter baru kelas untuk file yang ditentukan pada jalur yang ditentukan, menggunakan pengodean dan ukuran buffer yang ditentukan. Jika ada, file dapat ditimpa atau ditambahkan. Jika file tidak ada, konstruktor ini membuat file baru.

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)

Parameter

path

String

Jalur file lengkap untuk ditulis.

append

Boolean

true untuk menambahkan data ke file; false untuk menimpa file. Jika file yang ditentukan tidak ada, parameter ini tidak berpengaruh, dan konstruktor membuat file baru.

encoding

Encoding

Pengodean karakter yang akan digunakan.

bufferSize

Int32

Ukuran buffer, dalam byte.

Pengecualian

ArgumentException

path adalah string kosong ("").

-atau-

path berisi nama perangkat sistem (com1, com2, dan sebagainya).

ArgumentNullException

path atau encoding adalah null.

ArgumentOutOfRangeException

bufferSize negatif.

IOException

path menyertakan sintaksis yang salah atau tidak valid untuk nama file, nama direktori, atau sintaks label volume.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

UnauthorizedAccessException

Akses ditolak.

DirectoryNotFoundException

Jalur yang ditentukan tidak valid (misalnya, jalur tersebut berada pada drive yang tidak dipetakan).

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

Contoh

Contoh berikut menunjukkan konstruktor ini.

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

Keterangan

Konstruktor ini menginisialisasi Encoding properti menggunakan parameter pengodean. Untuk informasi tambahan, lihat Encoding.

path dapat berupa nama file, termasuk file pada berbagi Universal Naming Convention (UNC).

path tidak diperlukan untuk menjadi file yang disimpan pada disk; ini dapat menjadi bagian mana pun dari sistem yang mendukung akses melalui aliran.

Perhatian

Ketika Anda mengkompilasi sekumpulan karakter dengan pengaturan budaya tertentu dan mengambil karakter yang sama dengan pengaturan budaya yang berbeda, karakter mungkin tidak dapat ditafsirkan, dan dapat menyebabkan pengecualian dilemparkan.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• Encoding
• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File