StreamWriter StreamWriter StreamWriter StreamWriter Constructors

定義

オーバーロード

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.

例外

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

次のコード例は、このコンストラクターを示しています。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

注釈

このコンストラクターは、 StreamWriterバイト順マーク (BOM) を使用せずに utf-8 エンコーディングを使用し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 encoding オブジェクトによって提供される動作とは異なります。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. プロパティは、 streamパラメーターを使用して初期化されます。 BaseStreamThe 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.

こちらもご覧ください

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.

例外

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.

次のコード例は、このコンストラクターを示しています。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

注釈

このコンストラクターは、 StreamWriterバイト順マーク (BOM) を使用せずに utf-8 エンコーディングを使用し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 encoding オブジェクトによって提供される動作とは異なります。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.

セキュリティ

FileIOPermission
ファイルの読み取りと書き込みを行います。for reading and writing files. 関連付けられReadた列挙型:、WriteAssociated enumeration: Read, Write

こちらもご覧ください

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.

例外

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

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

このコンストラクターの例を次に示します。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

注釈

このコンストラクターは、 Encoding 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.

こちらもご覧ください

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、ファイルを上書きする場合は falsetrue 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.

例外

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.

次のコード例は、このコンストラクターを示しています。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

注釈

このコンストラクターは、 StreamWriterバイト順マーク (BOM) を使用せずに utf-8 エンコーディングを使用し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 encoding オブジェクトによって提供される動作とは異なります。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.

セキュリティ

FileIOPermission
ファイルの読み取りと書き込みを行います。for reading and writing files. 関連付けられReadた列挙型:、WriteAssociated enumeration: Read, Write

こちらもご覧ください

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.

例外

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

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

このコンストラクターの例を次に示します。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

注釈

このコンストラクターは、 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.

こちらもご覧ください

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、ファイルを上書きする場合は falsetrue 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.

例外

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.

このコンストラクターの例を次に示します。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

注釈

このコンストラクターは、 Encoding 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.

セキュリティ

FileIOPermission
ファイルの読み取りと書き込みを行います。for reading and writing files. 関連付けられReadた列挙型:、WriteAssociated enumeration: Read, Write

こちらもご覧ください

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、それ以外の場合は falsetrue to leave the stream open after the StreamWriter object is disposed; otherwise, false.

例外

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

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

このコンストラクターの例を次に示します。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

注釈

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

このコンストラクターは、 Encoding encoding streamパラメーターを使用してプロパティを初期化し、パラメーターを使用してプロパティを初期化します。BaseStreamThis 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、ファイルを上書きする場合は falsetrue 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.

例外

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.

このコンストラクターの例を次に示します。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

注釈

このコンストラクターは、 Encoding 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.

セキュリティ

FileIOPermission
ファイルの読み取りと書き込みを行います。for reading and writing files. 関連付けられReadた列挙型:、WriteAssociated enumeration: Read, Write

こちらもご覧ください

適用対象