StreamWriter StreamWriter StreamWriter StreamWriter Constructors

Definition

Overloads

StreamWriter(Stream) StreamWriter(Stream) StreamWriter(Stream)

UTF-8 エンコーディングと既定のバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified stream by using UTF-8 encoding and the default buffer size.

StreamWriter(String) StreamWriter(String) StreamWriter(String) StreamWriter(String)

既定のエンコーディングとバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified file by using the default encoding and buffer size.

StreamWriter(Stream, Encoding) StreamWriter(Stream, Encoding) StreamWriter(Stream, Encoding)

指定したエンコーディングと既定のバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and the default buffer size.

StreamWriter(String, Boolean) StreamWriter(String, Boolean) StreamWriter(String, Boolean) StreamWriter(String, Boolean)

既定のエンコーディングとバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified file by using the default encoding and buffer size. ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 If the file exists, it can be either overwritten or appended to. ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。 If the file does not exist, this constructor creates a new file.

StreamWriter(Stream, Encoding, Int32) StreamWriter(Stream, Encoding, Int32) StreamWriter(Stream, Encoding, Int32)

指定したエンコーディングとバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and buffer size.

StreamWriter(String, Boolean, Encoding) StreamWriter(String, Boolean, Encoding) StreamWriter(String, Boolean, Encoding)

指定したエンコーディングと既定のバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified file by using the specified encoding and default buffer size. ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 If the file exists, it can be either overwritten or appended to. ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。 If the file does not exist, this constructor creates a new file.

StreamWriter(Stream, Encoding, Int32, Boolean) StreamWriter(Stream, Encoding, Int32, Boolean) StreamWriter(Stream, Encoding, Int32, Boolean)

指定した円コーディングとバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化し、必要に応じて、ストリームを開いたままにします。 Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and buffer size, and optionally leaves the stream open.

StreamWriter(String, Boolean, Encoding, Int32) StreamWriter(String, Boolean, Encoding, Int32) StreamWriter(String, Boolean, Encoding, Int32)

指定したエンコーディングとバッファー サイズを使用して、指定したパス上の指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified file on the specified path, using the specified encoding and buffer size. ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 If the file exists, it can be either overwritten or appended to. ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。 If the file does not exist, this constructor creates a new file.

StreamWriter(Stream) StreamWriter(Stream) StreamWriter(Stream)

UTF-8 エンコーディングと既定のバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified stream by using UTF-8 encoding and the default buffer size.

public:
 StreamWriter(System::IO::Stream ^ stream);
public StreamWriter (System.IO.Stream stream);
new System.IO.StreamWriter : System.IO.Stream -> System.IO.StreamWriter

パラメーター

stream
Stream Stream Stream Stream

書き込まれるストリーム。 The stream to write to.

Exceptions

stream が書き込み可能ではありません。 stream is not writable.

Examples

次のコード例では、このコンス トラクターを示します。The following code example demonstrates this constructor.

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

Remarks

このコンス トラクターを作成、 StreamWriter utf-8 エンコード付きでせずバイト オーダー マーク (BOM) ので、GetPreambleメソッドは空のバイト配列を返します。This constructor creates a StreamWriter with UTF-8 encoding without a Byte-Order Mark (BOM), so its GetPreamble method returns an empty byte array. このコンス トラクターの既定の utf-8 エンコードでは、無効なバイトで例外をスローします。The default UTF-8 encoding for this constructor throws an exception on invalid bytes. この動作のエンコーディング オブジェクトによって提供される動作とは異なります、Encoding.UTF8プロパティ。This behavior is different from the behavior provided by the encoding object in the Encoding.UTF8 property. 無効なバイトで例外がスローするかどうかを指定するなど、パラメーターとしてのエンコーディング オブジェクトを受け取るコンス トラクターを使用して、StreamWriterします。To specify whether an exception is thrown on invalid bytes, use a constructor that accepts an encoding object as a parameter, such as StreamWriter. BaseStreamを使用してプロパティを初期化、streamパラメーター。The BaseStream property is initialized using the stream parameter. ストリームの位置はリセットされません。The position of the stream is not reset.

StreamWriterオブジェクト呼び出しDispose()提供されたStreamオブジェクトとStreamWriter.Disposeが呼び出されます。The StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

注意事項

特定のカルチャ設定と一連の文字をコンパイルして、同じ文字を別のカルチャ設定を取得すると、文字は解釈されないことしがスローされる例外が発生する可能性があります。When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable and could cause an exception to be thrown.

共通 I/O タスクの一覧は、次を参照してください。共通 I/O タスクします。For a list of common I/O tasks, see Common I/O Tasks.

See Also

StreamWriter(String) StreamWriter(String) StreamWriter(String) StreamWriter(String)

既定のエンコーディングとバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified file by using the default encoding and buffer size.

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

書き込まれる完全なファイルパス。 The complete file path to write to. path はファイル名にすることもできます。 path can be a file name.

Exceptions

path が空の文字列 ("") です。 path is an empty string (""). - または - -or- path には、システム デバイスの名前 (com1、com2 など) が含まれます。 path contains the name of a system device (com1, com2, and so on).

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。 The specified path is invalid (for example, it is on an unmapped drive).

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。 The specified path, file name, or both exceed the system-defined maximum length.

path には、ファイル名、ディレクトリ名、またはボリューム ラベルの不正な構文または無効な構文が含まれています。 path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

呼び出し元に、必要なアクセス許可がありません。 The caller does not have the required permission.

Examples

次のコード例では、このコンス トラクターを示します。The following code example demonstrates this constructor.

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

Remarks

このコンス トラクターを作成、 StreamWriter utf-8 エンコード付きでせずバイト オーダー マーク (BOM) ので、GetPreambleメソッドは空のバイト配列を返します。This constructor creates a StreamWriter with UTF-8 encoding without a Byte-Order Mark (BOM), so its GetPreamble method returns an empty byte array. このコンス トラクターの既定の utf-8 エンコードでは、無効なバイトで例外をスローします。The default UTF-8 encoding for this constructor throws an exception on invalid bytes. この動作のエンコーディング オブジェクトによって提供される動作とは異なります、Encoding.UTF8プロパティ。This behavior is different from the behavior provided by the encoding object in the Encoding.UTF8 property. BOM を指定し、無効なバイトで例外がスローするかどうかを判断するには、エンコーディング オブジェクトをなど、パラメーターとして受け取るコンス トラクターを使用StreamWriter(String, Boolean, Encoding)します。To specify a BOM and determine whether an exception is thrown on invalid bytes, use a constructor that accepts an encoding object as a parameter, such as StreamWriter(String, Boolean, Encoding).

pathパラメーターは、汎用名前付け規則 (UNC) 共有上のファイルを含む、ファイル名を指定できます。The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share. ファイルが存在する場合は上書きされます。それ以外の場合、新しいファイルが作成されます。If the file exists, it is overwritten; otherwise, a new file is created.

pathパラメーターは、ディスクに格納されているファイルは必要ありません。 ストリームを使用してアクセスをサポートするシステムの一部であることができます。The path parameter is not required to be a file stored on disk; it can be any part of a system that supports access using streams.

注意事項

特定のカルチャ設定と一連の文字をコンパイルして、同じ文字を別のカルチャ設定を取得すると、文字は解釈されないことしがスローされる例外が発生する可能性があります。When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable and could cause an exception to be thrown.

共通 I/O タスクの一覧は、次を参照してください。共通 I/O タスクします。For a list of common I/O tasks, see Common I/O Tasks.

Security

FileIOPermission
ファイルを読み書きします。 for reading and writing files. 列挙型に関連付けられている: ReadWrite Associated enumeration: Read, Write

See Also

StreamWriter(Stream, Encoding) StreamWriter(Stream, Encoding) StreamWriter(Stream, Encoding)

指定したエンコーディングと既定のバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and the default buffer size.

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

パラメーター

stream
Stream Stream Stream Stream

書き込まれるストリーム。 The stream to write to.

encoding
Encoding Encoding Encoding Encoding

使用する文字エンコーディング。 The character encoding to use.

Exceptions

stream または encodingnull です。 stream or encoding is null.

stream が書き込み可能ではありません。 stream is not writable.

Examples

次の例では、このコンス トラクターを示します。The following example demonstrates this constructor.

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

Remarks

このコンス トラクターを初期化します、Encodingエンコード パラメーターを使用してプロパティとBaseStreamストリーム パラメーターを使用するプロパティ。This constructor initializes the Encoding property using the encoding parameter, and the BaseStream property using the stream parameter. ストリームの位置はリセットされません。The position of the stream is not reset. 詳細については、「Encoding」を参照してください。For additional information, see Encoding.

StreamWriterオブジェクト呼び出しDispose()提供されたStreamオブジェクトとStreamWriter.Disposeが呼び出されます。The StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

注意事項

特定のカルチャ設定と一連の文字をコンパイルして、同じ文字を別のカルチャ設定を取得すると、文字は、解釈されないことしがスローされる例外が発生する可能性があります。When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

共通 I/O タスクの一覧は、次を参照してください。共通 I/O タスクします。For a list of common I/O tasks, see Common I/O Tasks.

See Also

StreamWriter(String, Boolean) StreamWriter(String, Boolean) StreamWriter(String, Boolean) StreamWriter(String, Boolean)

既定のエンコーディングとバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified file by using the default encoding and buffer size. ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 If the file exists, it can be either overwritten or appended to. ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。 If the file does not exist, this constructor creates a new file.

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

書き込まれる完全なファイルパス。 The complete file path to write to.

append
Boolean Boolean Boolean Boolean

データをファイルに追加する場合は true、ファイルを上書きする場合は false true to append data to the file; false to overwrite the file. 指定されたファイルが存在しない場合、このパラメーターは無効であり、コンストラクターは新しいファイルを作成します。 If the specified file does not exist, this parameter has no effect, and the constructor creates a new file.

Exceptions

path が空です。 path is empty. - または - -or- path には、システム デバイスの名前 (com1、com2 など) が含まれます。 path contains the name of a system device (com1, com2, and so on).

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。 The specified path is invalid (for example, it is on an unmapped drive).

path には、ファイル名、ディレクトリ名、またはボリューム ラベルの不正な構文または無効な構文が含まれています。 path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。 The specified path, file name, or both exceed the system-defined maximum length.

呼び出し元に、必要なアクセス許可がありません。 The caller does not have the required permission.

Examples

次のコード例では、このコンス トラクターを示します。The following code example demonstrates this constructor.

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

Remarks

このコンス トラクターを作成、 StreamWriter utf-8 エンコード付きでせずバイト オーダー マーク (BOM) ので、GetPreambleメソッドは空のバイト配列を返します。This constructor creates a StreamWriter with UTF-8 encoding without a Byte-Order Mark (BOM), so its GetPreamble method returns an empty byte array. このコンス トラクターの既定の utf-8 エンコードでは、無効なバイトで例外をスローします。The default UTF-8 encoding for this constructor throws an exception on invalid bytes. この動作のエンコーディング オブジェクトによって提供される動作とは異なります、Encoding.UTF8プロパティ。This behavior is different from the behavior provided by the encoding object in the Encoding.UTF8 property. BOM を指定し、無効なバイトで例外がスローするかどうかを判断するには、エンコーディング オブジェクトをなど、パラメーターとして受け取るコンス トラクターを使用StreamWriter(String, Boolean, Encoding)します。To specify a BOM and determine whether an exception is thrown on invalid bytes, use a constructor that accepts an encoding object as a parameter, such as StreamWriter(String, Boolean, Encoding).

pathパラメーターは、汎用名前付け規則 (UNC) 共有上のファイルを含む、ファイル名を指定できます。The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.

pathパラメーターは、ディスクに格納されているファイルは必要ありません。 ストリームを使用してアクセスをサポートするシステムの一部であることができます。The path parameter is not required to be a file stored on disk; it can be any part of a system that supports access using streams.

注意事項

特定のカルチャ設定と一連の文字をコンパイルして、同じ文字を別のカルチャ設定を取得すると、文字は、解釈されないことしがスローされる例外が発生する可能性があります。When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

共通 I/O タスクの一覧は、次を参照してください。共通 I/O タスクします。For a list of common I/O tasks, see Common I/O Tasks.

Security

FileIOPermission
ファイルを読み書きします。 for reading and writing files. 列挙型に関連付けられている: ReadWrite Associated enumeration: Read, Write

See Also

StreamWriter(Stream, Encoding, Int32) StreamWriter(Stream, Encoding, Int32) StreamWriter(Stream, Encoding, Int32)

指定したエンコーディングとバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and buffer size.

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

パラメーター

stream
Stream Stream Stream Stream

書き込まれるストリーム。 The stream to write to.

encoding
Encoding Encoding Encoding Encoding

使用する文字エンコーディング。 The character encoding to use.

bufferSize
Int32 Int32 Int32 Int32

バイト単位のバッファー サイズ。 The buffer size, in bytes.

Exceptions

stream または encodingnull です。 stream or encoding is null.

stream が書き込み可能ではありません。 stream is not writable.

Examples

次の例では、このコンス トラクターを示します。The following example demonstrates this constructor.

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

Remarks

このコンス トラクターを初期化します、Encodingプロパティを使用して、encodingパラメーター、およびBaseStreamプロパティを使用して、streamパラメーター。This constructor initializes the Encoding property using the encoding parameter, and the BaseStream property using the stream parameter. ストリームの位置はリセットされません。The position of the stream is not reset. 詳細については、「Encoding」を参照してください。For additional information, see Encoding.

StreamWriterオブジェクト呼び出しDispose()提供されたStreamオブジェクトとStreamWriter.Disposeが呼び出されます。The StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

注意事項

特定のカルチャ設定と一連の文字をコンパイルして、同じ文字を別のカルチャ設定を取得すると、文字は、解釈されないことしがスローされる例外が発生する可能性があります。When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

共通 I/O タスクの一覧は、次を参照してください。共通 I/O タスクします。For a list of common I/O tasks, see Common I/O Tasks.

See Also

StreamWriter(String, Boolean, Encoding) StreamWriter(String, Boolean, Encoding) StreamWriter(String, Boolean, Encoding)

指定したエンコーディングと既定のバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified file by using the specified encoding and default buffer size. ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 If the file exists, it can be either overwritten or appended to. ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。 If the file does not exist, this constructor creates a new file.

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

パラメーター

path
String String String String

書き込まれる完全なファイルパス。 The complete file path to write to.

append
Boolean Boolean Boolean Boolean

データをファイルに追加する場合は true、ファイルを上書きする場合は false true to append data to the file; false to overwrite the file. 指定されたファイルが存在しない場合、このパラメーターは無効であり、コンストラクターは新しいファイルを作成します。 If the specified file does not exist, this parameter has no effect, and the constructor creates a new file.

encoding
Encoding Encoding Encoding Encoding

使用する文字エンコーディング。 The character encoding to use.

Exceptions

path が空です。 path is empty. - または - -or- path には、システム デバイスの名前 (com1、com2 など) が含まれます。 path contains the name of a system device (com1, com2, and so on).

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。 The specified path is invalid (for example, it is on an unmapped drive).

path には、ファイル名、ディレクトリ名、またはボリューム ラベルの不正な構文または無効な構文が含まれています。 path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。 The specified path, file name, or both exceed the system-defined maximum length.

呼び出し元に、必要なアクセス許可がありません。 The caller does not have the required permission.

Examples

次の例では、このコンス トラクターを示します。The following example demonstrates this constructor.

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

Remarks

このコンス トラクターの初期化、Encodingエンコード パラメーターを使用するプロパティ。This constructor initializes the Encoding property using the encoding parameter. 詳細については、「Encoding」を参照してください。For additional information, see Encoding.

path 汎用名前付け規則 (UNC) 共有上のファイルを含む、ファイル名であることができます。path can be a file name, including a file on a Universal Naming Convention (UNC) share.

path ディスクに格納されているファイルにする必要はありません。ストリーム経由でアクセスをサポートするシステムの任意の部分であることができます。path is not required to be a file stored on disk; it can be any part of a system that supports access via streams.

注意事項

特定のカルチャ設定と一連の文字をコンパイルして、同じ文字を別のカルチャ設定を取得すると、文字は、解釈されないことしがスローされる例外が発生する可能性があります。When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

共通 I/O タスクの一覧は、次を参照してください。共通 I/O タスクします。For a list of common I/O tasks, see Common I/O Tasks.

Security

FileIOPermission
ファイルを読み書きします。 for reading and writing files. 列挙型に関連付けられている: ReadWrite Associated enumeration: Read, Write

See Also

StreamWriter(Stream, Encoding, Int32, Boolean) StreamWriter(Stream, Encoding, Int32, Boolean) StreamWriter(Stream, Encoding, Int32, Boolean)

指定した円コーディングとバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化し、必要に応じて、ストリームを開いたままにします。 Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and buffer size, and optionally leaves the stream open.

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);
new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int * bool -> System.IO.StreamWriter

パラメーター

stream
Stream Stream Stream Stream

書き込まれるストリーム。 The stream to write to.

encoding
Encoding Encoding Encoding Encoding

使用する文字エンコーディング。 The character encoding to use.

bufferSize
Int32 Int32 Int32 Int32

バイト単位のバッファー サイズ。 The buffer size, in bytes.

leaveOpen
Boolean Boolean Boolean Boolean

StreamWriter オブジェクトを破棄した後にストリームを開いたままにする場合は true、それ以外の場合は false true to leave the stream open after the StreamWriter object is disposed; otherwise, false.

Exceptions

stream または encodingnull です。 stream or encoding is null.

stream が書き込み可能ではありません。 stream is not writable.

Examples

次の例では、このコンス トラクターを示します。The following example demonstrates this constructor.

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

Remarks

設定しない限り、leaveOpenパラメーターをtrueStreamWriterオブジェクト呼び出しDispose()提供されたStreamオブジェクトとStreamWriter.Disposeが呼び出されます。Unless you set the leaveOpen parameter to true, the StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

このコンス トラクターの初期化、Encodingプロパティを使用して、encodingパラメーター、および初期化、BaseStreamプロパティを使用して、streamパラメーター。This constructor initializes the Encoding property by using the encoding parameter, and initializes the BaseStream property by using the stream parameter. ストリームの位置はリセットされません。The position of the stream is not reset. 詳細については、次を参照してください。、Encodingプロパティ。For additional information, see the Encoding property.

注意事項

特定のカルチャ設定と一連の文字をコンパイルして、同じ文字を別のカルチャ設定を取得すると、文字は、解釈されないことしがスローされる例外が発生する可能性があります。When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

StreamWriter(String, Boolean, Encoding, Int32) StreamWriter(String, Boolean, Encoding, Int32) StreamWriter(String, Boolean, Encoding, Int32)

指定したエンコーディングとバッファー サイズを使用して、指定したパス上の指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 Initializes a new instance of the StreamWriter class for the specified file on the specified path, using the specified encoding and buffer size. ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 If the file exists, it can be either overwritten or appended to. ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。 If the file does not exist, this constructor creates a new file.

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

パラメーター

path
String String String String

書き込まれる完全なファイルパス。 The complete file path to write to.

append
Boolean Boolean Boolean Boolean

データをファイルに追加する場合は true、ファイルを上書きする場合は false true to append data to the file; false to overwrite the file. 指定されたファイルが存在しない場合、このパラメーターは無効であり、コンストラクターは新しいファイルを作成します。 If the specified file does not exist, this parameter has no effect, and the constructor creates a new file.

encoding
Encoding Encoding Encoding Encoding

使用する文字エンコーディング。 The character encoding to use.

bufferSize
Int32 Int32 Int32 Int32

バイト単位のバッファー サイズ。 The buffer size, in bytes.

Exceptions

path が空の文字列 ("") です。 path is an empty string (""). - または - -or- path には、システム デバイスの名前 (com1、com2 など) が含まれます。 path contains the name of a system device (com1, com2, and so on).

path または encodingnull です。 path or encoding is null.

path には、ファイル名、ディレクトリ名、またはボリューム ラベルの不正な構文または無効な構文が含まれています。 path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

呼び出し元に、必要なアクセス許可がありません。 The caller does not have the required permission.

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。 The specified path is invalid (for example, it is on an unmapped drive).

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。 The specified path, file name, or both exceed the system-defined maximum length.

Examples

次の例では、このコンス トラクターを示します。The following example demonstrates this constructor.

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

Remarks

このコンス トラクターの初期化、Encodingエンコード パラメーターを使用するプロパティ。This constructor initializes the Encoding property using the encoding parameter. 詳細については、「Encoding」を参照してください。For additional information, see Encoding.

path 汎用名前付け規則 (UNC) 共有上のファイルを含む、ファイル名であることができます。path can be a file name, including a file on a Universal Naming Convention (UNC) share.

path ディスクに格納されているファイルにする必要はありません。ストリーム経由でアクセスをサポートするシステムの任意の部分であることができます。path is not required to be a file stored on disk; it can be any part of a system that supports access via streams.

注意事項

特定のカルチャ設定と一連の文字をコンパイルして、同じ文字を別のカルチャ設定を取得すると、文字は、解釈されないことしがスローされる例外が発生する可能性があります。When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

共通 I/O タスクの一覧は、次を参照してください。共通 I/O タスクします。For a list of common I/O tasks, see Common I/O Tasks.

Security

FileIOPermission
ファイルを読み書きします。 for reading and writing files. 列挙型に関連付けられている: ReadWrite Associated enumeration: Read, Write

See Also

Applies to