StreamWriter コンストラクター

定義

StreamWriter クラスの新しいインスタンスを初期化します。Initializes a new instance of the StreamWriter class.

オーバーロード

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 クラスの新しいインスタンスを初期化します。Initializes a new instance of the StreamWriter class for the specified file by using the default encoding and buffer size.

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 クラスの新しいインスタンスを初期化します。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 クラスの新しいインスタンスを初期化します。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 クラスの新しいインスタンスを初期化します。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 クラスの新しいインスタンスを初期化し、必要に応じて、ストリームを開いたままにします。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 クラスの新しいインスタンスを初期化します。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)

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

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

例外

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

streamnull です。stream is null.

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

注釈

このコンストラクターは、バイト順マーク (BOM) を使用せずに UTF-8 エンコーディングを使用して StreamWriter を作成します。そのため、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. BaseStream プロパティは、stream パラメーターを使用して初期化されます。The BaseStream property is initialized using the stream parameter. ストリームの位置はリセットされません。The position of the stream is not reset.

StreamWriter オブジェクトは StreamWriter.Dispose が呼び出されたときに、指定された Stream オブジェクトで 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 クラスの新しいインスタンスを初期化します。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

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

例外

アクセスが拒否されました。Access is denied.

path が空の文字列 ("") です。path is an empty string ("").

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

pathnull です。path is null.

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。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

注釈

このコンストラクターは、バイト順マーク (BOM) を使用せずに UTF-8 エンコーディングを使用して StreamWriter を作成します。そのため、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. 関連付けられた列挙型: ReadWriteAssociated enumeration: Read, Write

こちらもご覧ください

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

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

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 オブジェクトは StreamWriter.Dispose が呼び出されたときに、指定された Stream オブジェクトで 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 クラスの新しいインスタンスを初期化します。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

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

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

例外

アクセスが拒否されました。Access is denied.

path が空です。path is empty.

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

pathnull です。path is null.

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。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

注釈

このコンストラクターは、バイト順マーク (BOM) を使用せずに UTF-8 エンコーディングを使用して StreamWriter を作成します。そのため、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. 関連付けられた列挙型: ReadWriteAssociated enumeration: Read, Write

こちらもご覧ください

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

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

encoding
Encoding

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

bufferSize
Int32

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

例外

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

bufferSize は負の値です。bufferSize is negative.

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 プロパティを初期化し、stream パラメーターを使用して 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 オブジェクトは StreamWriter.Dispose が呼び出されたときに、指定された Stream オブジェクトで 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 クラスの新しいインスタンスを初期化します。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

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

append
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

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

例外

アクセスが拒否されました。Access is denied.

path が空です。path is empty.

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

pathnull です。path is null.

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。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. 関連付けられた列挙型: ReadWriteAssociated enumeration: Read, Write

こちらもご覧ください

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 = null, int bufferSize = -1, bool leaveOpen = false);
new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int * bool -> System.IO.StreamWriter

パラメーター

stream
Stream

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

encoding
Encoding

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

bufferSize
Int32

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

leaveOpen
Boolean

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

例外

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

bufferSize は負の値です。bufferSize is negative.

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 パラメーターを trueに設定しない限り、StreamWriter オブジェクトは Stream が呼び出されたときに、指定された StreamWriter.Dispose オブジェクトの 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 プロパティを初期化し、stream パラメーターを使用して BaseStream プロパティを初期化します。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 クラスの新しいインスタンスを初期化します。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

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

append
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

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

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

bufferSize は負の値です。bufferSize is negative.

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.

アクセスが拒否されました。Access is denied.

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。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. 関連付けられた列挙型: ReadWriteAssociated enumeration: Read, Write

こちらもご覧ください

適用対象