StreamWriter 생성자

정의

네임스페이스:

System.IO

어셈블리:

System.Runtime.dll

StreamWriter 클래스의 새 인스턴스를 초기화합니다.

오버로드

StreamWriter(Stream)	UTF-8 인코딩과 기본 버퍼 크기를 사용하여 지정된 스트림에 대해 StreamWriter 클래스의 새 인스턴스를 초기화합니다.
StreamWriter(String)	기본 인코딩 및 버퍼 크기를 사용하여 지정된 파일에 대해 StreamWriter 클래스의 새 인스턴스를 초기화합니다.
StreamWriter(Stream, Encoding)	지정된 인코딩과 기본 버퍼 크기를 사용하여 지정된 스트림에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다.
StreamWriter(String, Boolean)	기본 인코딩 및 버퍼 크기를 사용하여 지정된 파일에 대해 StreamWriter 클래스의 새 인스턴스를 초기화합니다. 해당 파일이 있으면 덮어쓰거나 추가합니다. 해당 파일이 없으면 이 생성자는 새 파일을 만듭니다.
StreamWriter(String, FileStreamOptions)	기본 인코딩을 사용하여 지정된 파일에 대한 클래스의 StreamWriter 새 instance 초기화하고 지정된 개체로 구성합니다FileStreamOptions.
StreamWriter(Stream, Encoding, Int32)	지정된 인코딩과 버퍼 크기를 사용하여 지정된 스트림에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다.
StreamWriter(String, Boolean, Encoding)	지정된 인코딩 및 기본 버퍼 크기를 사용하여 지정된 파일에 대해 StreamWriter 클래스의 새 인스턴스를 초기화합니다. 해당 파일이 있으면 덮어쓰거나 추가합니다. 해당 파일이 없으면 이 생성자는 새 파일을 만듭니다.
StreamWriter(String, Encoding, FileStreamOptions)	지정된 인코딩을 사용하여 지정된 파일에 대한 클래스의 StreamWriter 새 instance 초기화하고 지정된 개체로 구성합니다FileStreamOptions.
StreamWriter(Stream, Encoding, Int32, Boolean)	지정된 인코딩과 기본 버퍼 크기를 사용하여 지정된 스트림에 대한 StreamWriter 클래스의 새 인스턴스를 초기화하며, 선택적으로 스트림을 연 상태로 둘 수 있습니다.
StreamWriter(String, Boolean, Encoding, Int32)	지정된 인코딩과 버퍼 크기를 사용하여 지정 경로의 지정 파일에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다. 해당 파일이 있으면 덮어쓰거나 추가합니다. 해당 파일이 없으면 이 생성자는 새 파일을 만듭니다.

StreamWriter(Stream)

Source:

StreamWriter.cs

UTF-8 인코딩과 기본 버퍼 크기를 사용하여 지정된 스트림에 대해 StreamWriter 클래스의 새 인스턴스를 초기화합니다.

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)

매개 변수

stream

Stream

쓸 스트림입니다.

예외

ArgumentException

stream에 쓸 수 없습니다.

ArgumentNullException

stream이(가) null인 경우

예제

다음 코드 예제에서는이 생성자를 보여 줍니다.

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

설명

이 생성자는 BOM(Byte-Order Mark) 없이 UTF-8 인코딩을 사용하여 를 만들어 StreamWriter 메서드가 GetPreamble 빈 바이트 배열을 반환합니다. 이 생성자에 대한 기본 UTF-8 인코딩은 잘못된 바이트에 대한 예외를 throw합니다. 이 동작은 속성의 인코딩 개체에서 Encoding.UTF8 제공하는 동작과 다릅니다. 잘못된 바이트에서 예외가 throw되는지 여부를 지정하려면 인코딩 개체를 매개 변수(예: )로 StreamWriter허용하는 생성자를 사용합니다. 속성은 BaseStream 매개 변수를 사용하여 초기화됩니다 stream . 스트림의 위치가 다시 설정되지 않습니다.

개체는 StreamWriter 가 호출될 때 StreamWriter.Dispose 제공된 개체를 Stream 호출 Dispose() 합니다.

주의

특정 문화권 설정을 사용하여 문자 집합을 컴파일하고 다른 문화권 설정으로 동일한 문자를 검색하는 경우 문자를 해석할 수 없으며 예외가 throw될 수 있습니다.

일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.

추가 정보

• 파일 및 스트림 I/O
• 방법: 파일에서 텍스트 읽기
• 방법: 파일에 텍스트 쓰기

StreamWriter(String)

Source:

StreamWriter.cs

기본 인코딩 및 버퍼 크기를 사용하여 지정된 파일에 대해 StreamWriter 클래스의 새 인스턴스를 초기화합니다.

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

public StreamWriter (string path);

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

Public Sub New (path As String)

매개 변수

path

String

기록할 전체 파일 경로입니다. path는 파일 이름일 수 있습니다.

예외

UnauthorizedAccessException

액세스가 거부되었습니다.

ArgumentException

path가 빈 문자열("")인 경우

또는

path에 com1, com2 등의 시스템 디바이스 이름이 포함되어 있는 경우

ArgumentNullException

path이(가) null인 경우

DirectoryNotFoundException

지정된 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).

PathTooLongException

지정된 경로, 파일 이름 또는 둘 다가 시스템에서 정의한 최대 길이를 초과합니다.

IOException

path에 부정확하거나 올바르지 않은 파일 이름, 디렉터리 이름 또는 볼륨 레이블 구문이 있는 경우

SecurityException

호출자에게 필요한 권한이 없는 경우

예제

다음 코드 예제에서는이 생성자를 보여 줍니다.

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

설명

이 생성자는 BOM(Byte-Order Mark) 없이 UTF-8 인코딩을 사용하여 를 만들어 StreamWriter 메서드가 GetPreamble 빈 바이트 배열을 반환합니다. 이 생성자에 대한 기본 UTF-8 인코딩은 잘못된 바이트에 대한 예외를 throw합니다. 이 동작은 속성의 인코딩 개체에서 Encoding.UTF8 제공하는 동작과 다릅니다. BOM을 지정하고 잘못된 바이트에서 예외가 throw되는지 여부를 확인하려면 인코딩 개체를 매개 변수(예: )로 StreamWriter(String, Boolean, Encoding)허용하는 생성자를 사용합니다.

매개 변수는 path UNC(유니버설 명명 규칙) 공유의 파일을 포함하여 파일 이름일 수 있습니다. 파일이 있으면 덮어씁니다. 그렇지 않으면 새 파일이 만들어집니다.

path 매개 변수는 디스크에 저장된 파일일 필요는 없으며 스트림을 사용하여 액세스를 지원하는 시스템의 일부일 수 있습니다.

주의

특정 문화권 설정을 사용하여 문자 집합을 컴파일하고 다른 문화권 설정으로 동일한 문자를 검색하는 경우 문자를 해석할 수 없으며 예외가 throw될 수 있습니다.

일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.

추가 정보

• 파일 및 스트림 I/O
• 방법: 파일에서 텍스트 읽기
• 방법: 파일에 텍스트 쓰기

StreamWriter(Stream, Encoding)

Source:

StreamWriter.cs

지정된 인코딩과 기본 버퍼 크기를 사용하여 지정된 스트림에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다.

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)

매개 변수

stream

Stream

쓸 스트림입니다.

encoding

Encoding

사용할 문자 인코딩입니다.

예외

ArgumentNullException

stream 또는 encoding가 null인 경우

ArgumentException

stream에 쓸 수 없습니다.

예제

다음 예제에서는이 생성자를 보여 줍니다.

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

설명

이 생성자는 Encoding 인코딩 매개 변수를 사용 하 여 속성 및 BaseStream stream 매개 변수를 사용 하 여 속성입니다. 스트림의 위치가 다시 설정되지 않습니다. 자세한 내용은 Encoding을 참조하십시오.

개체는 StreamWriter 가 호출될 때 StreamWriter.Dispose 제공된 개체를 Stream 호출 Dispose() 합니다.

주의

특정 문화권 설정을 사용하여 문자 집합을 컴파일하고 다른 문화권 설정으로 동일한 문자를 검색하는 경우 문자를 해석할 수 없으며 예외가 throw될 수 있습니다.

일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.

추가 정보

• Encoding
• 파일 및 스트림 I/O
• 방법: 파일에서 텍스트 읽기
• 방법: 파일에 텍스트 쓰기

StreamWriter(String, Boolean)

Source:

StreamWriter.cs

기본 인코딩 및 버퍼 크기를 사용하여 지정된 파일에 대해 StreamWriter 클래스의 새 인스턴스를 초기화합니다. 해당 파일이 있으면 덮어쓰거나 추가합니다. 해당 파일이 없으면 이 생성자는 새 파일을 만듭니다.

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)

매개 변수

path

String

기록할 전체 파일 경로입니다.

append

Boolean

데이터를 파일에 추가하려면 true이고, 파일을 덮어쓰려면 false입니다. 지정한 파일이 없으며 이 매개 변수에 영향이 없으면 생성자는 새 파일을 만듭니다.

예외

UnauthorizedAccessException

액세스가 거부되었습니다.

ArgumentException

path가 비어 있는 경우

또는

path에 com1, com2 등의 시스템 디바이스 이름이 포함되어 있는 경우

ArgumentNullException

path이(가) null인 경우

DirectoryNotFoundException

지정된 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).

IOException

path에 부정확하거나 올바르지 않은 파일 이름, 디렉터리 이름 또는 볼륨 레이블 구문이 있는 경우

PathTooLongException

지정된 경로, 파일 이름 또는 둘 다가 시스템에서 정의한 최대 길이를 초과합니다.

SecurityException

호출자에게 필요한 권한이 없는 경우

예제

다음 코드 예제에서는이 생성자를 보여 줍니다.

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

설명

이 생성자는 BOM(Byte-Order Mark) 없이 UTF-8 인코딩을 사용하여 를 만들 StreamWriter 므로 메서드는 GetPreamble 빈 바이트 배열을 반환합니다. 이 생성자에 대한 기본 UTF-8 인코딩은 잘못된 바이트에 대한 예외를 throw합니다. 이 동작은 속성의 인코딩 개체에서 Encoding.UTF8 제공하는 동작과 다릅니다. BOM을 지정하고 잘못된 바이트에서 예외가 throw되는지 여부를 확인하려면 인코딩 개체를 매개 변수(예: )로 StreamWriter(String, Boolean, Encoding)허용하는 생성자를 사용합니다.

매개 변수는 path UNC(범용 명명 규칙) 공유의 파일을 포함하여 파일 이름이 될 수 있습니다.

매개 변수는 path 디스크에 저장된 파일일 필요는 없습니다. 스트림을 사용하여 액세스를 지원하는 시스템의 일부일 수 있습니다.

주의

특정 문화권 설정을 사용하여 문자 집합을 컴파일하고 다른 문화권 설정으로 동일한 문자를 검색하는 경우 문자를 해석할 수 없으며 예외가 throw될 수 있습니다.

일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.

추가 정보

• 파일 및 스트림 I/O
• 방법: 파일에서 텍스트 읽기
• 방법: 파일에 텍스트 쓰기

StreamWriter(String, FileStreamOptions)

Source:

StreamWriter.cs

기본 인코딩을 사용하여 지정된 파일에 대한 클래스의 StreamWriter 새 instance 초기화하고 지정된 개체로 구성합니다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)

매개 변수

path

String

기록할 전체 파일 경로입니다.

options

FileStreamOptions

기본 에 대한 구성 옵션을 지정하는 개체입니다 FileStream.

예외

ArgumentNullException

options 는 입니다 null .

ArgumentException

stream에 쓸 수 없습니다.

추가 정보

• 파일 및 스트림 I/O
• 방법: 파일에서 텍스트 읽기
• 방법: 파일에 텍스트 쓰기

StreamWriter(Stream, Encoding, Int32)

Source:

StreamWriter.cs

지정된 인코딩과 버퍼 크기를 사용하여 지정된 스트림에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다.

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)

매개 변수

stream

Stream

쓸 스트림입니다.

encoding

Encoding

사용할 문자 인코딩입니다.

bufferSize

Int32

버퍼 크기(바이트)입니다.

예외

ArgumentNullException

stream 또는 encoding가 null인 경우

ArgumentOutOfRangeException

bufferSize가 음수입니다.

ArgumentException

stream에 쓸 수 없습니다.

예제

다음 예제에서는이 생성자를 보여 줍니다.

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

설명

이 생성자는 매개 변수를 Encoding 사용하여 encoding 속성을 초기화하고 매개 변수를 BaseStream 사용하여 stream 속성을 초기화합니다. 스트림의 위치가 다시 설정되지 않습니다. 자세한 내용은 Encoding을 참조하십시오.

개체는 StreamWriter 가 호출될 때 StreamWriter.Dispose 제공된 Stream 개체에서 를 호출 Dispose() 합니다.

주의

특정 문화권 설정을 사용하여 문자 집합을 컴파일하고 다른 문화권 설정으로 동일한 문자를 검색하는 경우 문자를 해석할 수 없으며 예외가 throw될 수 있습니다.

일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.

추가 정보

• Encoding
• 파일 및 스트림 I/O
• 방법: 파일에서 텍스트 읽기
• 방법: 파일에 텍스트 쓰기

StreamWriter(String, Boolean, Encoding)

Source:

StreamWriter.cs

지정된 인코딩 및 기본 버퍼 크기를 사용하여 지정된 파일에 대해 StreamWriter 클래스의 새 인스턴스를 초기화합니다. 해당 파일이 있으면 덮어쓰거나 추가합니다. 해당 파일이 없으면 이 생성자는 새 파일을 만듭니다.

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)

매개 변수

path

String

기록할 전체 파일 경로입니다.

append

Boolean

데이터를 파일에 추가하려면 true이고, 파일을 덮어쓰려면 false입니다. 지정한 파일이 없으며 이 매개 변수에 영향이 없으면 생성자는 새 파일을 만듭니다.

encoding

Encoding

사용할 문자 인코딩입니다.

예외

UnauthorizedAccessException

액세스가 거부되었습니다.

ArgumentException

path가 비어 있는 경우

또는

path에 com1, com2 등의 시스템 디바이스 이름이 포함되어 있는 경우

ArgumentNullException

path이(가) null인 경우

DirectoryNotFoundException

지정된 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).

IOException

path에 부정확하거나 올바르지 않은 파일 이름, 디렉터리 이름 또는 볼륨 레이블 구문이 있는 경우

PathTooLongException

지정된 경로, 파일 이름 또는 둘 다가 시스템에서 정의한 최대 길이를 초과합니다.

SecurityException

호출자에게 필요한 권한이 없는 경우

예제

다음 예제에서는이 생성자를 보여 줍니다.

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

설명

이 생성자는 인코딩 매개 변수를 사용하여 속성을 초기화 Encoding 합니다. 자세한 내용은 Encoding을 참조하십시오.

path 는 UNC(범용 명명 규칙) 공유의 파일을 포함하여 파일 이름이 될 수 있습니다.

path 는 디스크에 저장된 파일일 필요가 없습니다. 스트림을 통한 액세스를 지원하는 시스템의 일부일 수 있습니다.

주의

특정 문화권 설정을 사용하여 문자 집합을 컴파일하고 다른 문화권 설정으로 동일한 문자를 검색하는 경우 문자를 해석할 수 없으며 예외가 throw될 수 있습니다.

일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.

추가 정보

• Encoding
• 파일 및 스트림 I/O
• 방법: 파일에서 텍스트 읽기
• 방법: 파일에 텍스트 쓰기

StreamWriter(String, Encoding, FileStreamOptions)

Source:

StreamWriter.cs

지정된 인코딩을 사용하고 지정된 개체로 구성된 FileStreamOptions 지정된 파일에 대한 클래스의 StreamWriter 새 instance 초기화합니다.

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)

매개 변수

path

String

기록할 전체 파일 경로입니다.

encoding

Encoding

사용할 문자 인코딩입니다.

options

FileStreamOptions

기본 에 대한 구성 옵션을 지정하는 개체입니다 FileStream.

예외

ArgumentNullException

options 는 입니다 null .

ArgumentException

stream에 쓸 수 없습니다.

추가 정보

• 파일 및 스트림 I/O
• 방법: 파일에서 텍스트 읽기
• 방법: 파일에 텍스트 쓰기

StreamWriter(Stream, Encoding, Int32, Boolean)

Source:

StreamWriter.cs

지정된 인코딩과 기본 버퍼 크기를 사용하여 지정된 스트림에 대한 StreamWriter 클래스의 새 인스턴스를 초기화하며, 선택적으로 스트림을 연 상태로 둘 수 있습니다.

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)

매개 변수

stream

Stream

쓸 스트림입니다.

encoding

Encoding

사용할 문자 인코딩입니다.

bufferSize

Int32

버퍼 크기(바이트)입니다.

leaveOpen

Boolean

StreamWriter 개체를 삭제한 후 스트림을 열어 두려면 true이고, 닫으려면 false입니다.

예외

ArgumentNullException

stream 또는 encoding가 null인 경우

ArgumentOutOfRangeException

bufferSize가 음수입니다.

ArgumentException

stream에 쓸 수 없습니다.

예제

다음 예제에서는이 생성자를 보여 줍니다.

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

설명

매개 변수를 leaveOpen 로 설정하지 않는 한 개체는 StreamWriter 가 호출될 때 StreamWriter.Dispose 제공된 Stream 개체에서 를 호출 Dispose()true합니다.

이 생성자는 매개 변수를 Encoding 사용하여 encoding 속성을 초기화하고 매개 변수를 BaseStream 사용하여 stream 속성을 초기화합니다. 스트림의 위치가 다시 설정되지 않습니다. 자세한 내용은 속성을 참조 Encoding 하세요.

주의

특정 문화권 설정을 사용하여 문자 집합을 컴파일하고 다른 문화권 설정으로 동일한 문자를 검색하는 경우 문자를 해석할 수 없으며 예외가 throw될 수 있습니다.

StreamWriter(String, Boolean, Encoding, Int32)

Source:

StreamWriter.cs

지정된 인코딩과 버퍼 크기를 사용하여 지정 경로의 지정 파일에 대한 StreamWriter 클래스의 새 인스턴스를 초기화합니다. 해당 파일이 있으면 덮어쓰거나 추가합니다. 해당 파일이 없으면 이 생성자는 새 파일을 만듭니다.

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)

매개 변수

path

String

기록할 전체 파일 경로입니다.

append

Boolean

데이터를 파일에 추가하려면 true이고, 파일을 덮어쓰려면 false입니다. 지정한 파일이 없으며 이 매개 변수에 영향이 없으면 생성자는 새 파일을 만듭니다.

encoding

Encoding

사용할 문자 인코딩입니다.

bufferSize

Int32

버퍼 크기(바이트)입니다.

예외

ArgumentException

path가 빈 문자열("")인 경우

또는

path에 com1, com2 등의 시스템 디바이스 이름이 포함되어 있는 경우

ArgumentNullException

path 또는 encoding가 null인 경우

ArgumentOutOfRangeException

bufferSize가 음수입니다.

IOException

path에 부정확하거나 올바르지 않은 파일 이름, 디렉터리 이름 또는 볼륨 레이블 구문이 있는 경우

SecurityException

호출자에게 필요한 권한이 없는 경우

UnauthorizedAccessException

액세스가 거부되었습니다.

DirectoryNotFoundException

지정된 경로가 잘못되었습니다(예: 매핑되지 않은 드라이브에 있음).

PathTooLongException

지정된 경로, 파일 이름 또는 둘 다가 시스템에서 정의한 최대 길이를 초과합니다.

예제

다음 예제에서는이 생성자를 보여 줍니다.

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

설명

이 생성자는 인코딩 매개 변수를 사용하여 속성을 초기화 Encoding 합니다. 자세한 내용은 Encoding을 참조하십시오.

path 는 UNC(범용 명명 규칙) 공유의 파일을 포함하여 파일 이름이 될 수 있습니다.

path 는 디스크에 저장된 파일일 필요가 없습니다. 스트림을 통한 액세스를 지원하는 시스템의 일부일 수 있습니다.

주의

특정 문화권 설정을 사용하여 문자 집합을 컴파일하고 다른 문화권 설정으로 동일한 문자를 검색하는 경우 문자를 해석할 수 없으며 예외가 throw될 수 있습니다.

일반적인 I/O 작업 목록은 일반적인 I/O 작업을 참조하세요.

추가 정보

• Encoding
• 파일 및 스트림 I/O
• 방법: 파일에서 텍스트 읽기
• 방법: 파일에 텍스트 쓰기