英語で読む

次の方法で共有


StreamWriter コンストラクター

定義

StreamWriter クラスの新しいインスタンスを初期化します。

オーバーロード

StreamWriter(Stream)

UTF-8 エンコーディングと既定のバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。

StreamWriter(String)

既定のエンコーディングとバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。

StreamWriter(Stream, Encoding)

指定したエンコーディングと既定のバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。

StreamWriter(String, Boolean)

既定のエンコーディングとバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。

StreamWriter(String, FileStreamOptions)

既定のエンコードを使用して、指定したオブジェクトで StreamWriter 構成された、指定したファイルの クラスの新しいインスタンスを FileStreamOptions 初期化します。

StreamWriter(Stream, Encoding, Int32)

指定したエンコーディングとバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。

StreamWriter(String, Boolean, Encoding)

指定したエンコーディングと既定のバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。

StreamWriter(String, Encoding, FileStreamOptions)

指定したエンコーディングを使用して、指定したオブジェクトで StreamWriter 構成された、指定したファイルの クラスの新しいインスタンスを FileStreamOptions 初期化します。

StreamWriter(Stream, Encoding, Int32, Boolean)

指定した円コーディングとバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化し、必要に応じて、ストリームを開いたままにします。

StreamWriter(String, Boolean, Encoding, Int32)

指定したエンコーディングとバッファー サイズを使用して、指定したパス上の指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。

StreamWriter(Stream)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

UTF-8 エンコーディングと既定のバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。

public StreamWriter (System.IO.Stream stream);

パラメーター

stream
Stream

書き込まれるストリーム。

例外

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

streamnullです。

次のコード例は、このコンストラクターを示しています。

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();
            }
        }
    }
}

注釈

このコンストラクターは、 StreamWriter Byte-Order Mark (BOM) を使用せずに UTF-8 エンコードを使用して を作成するため、その GetPreamble メソッドは空のバイト配列を返します。 このコンストラクターの既定の UTF-8 エンコードでは、無効なバイトで例外がスローされます。 この動作は、 プロパティのエンコード オブジェクト Encoding.UTF8 によって提供される動作とは異なります。 無効なバイトで例外がスローされるかどうかを指定するには、 などの StreamWriterエンコード オブジェクトをパラメーターとして受け入れるコンストラクターを使用します。 プロパティは BaseStream 、 パラメーターを stream 使用して初期化されます。 ストリームの位置はリセットされません。

オブジェクトは StreamWriter 、 が呼び出 Dispose() されたときに、指定された Stream オブジェクトに対して StreamWriter.Dispose を呼び出します。

注意事項

特定のカルチャ設定で一連の文字をコンパイルし、異なるカルチャ設定を持つ同じ文字を取得すると、文字が解釈できず、例外がスローされる可能性があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

StreamWriter(String)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

既定のエンコーディングとバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。

public StreamWriter (string path);

パラメーター

path
String

書き込まれる完全なファイルパス。 path はファイル名にすることもできます。

例外

アクセスが拒否されました。

path が空の文字列 ("") です。

- または -

path には、システム デバイスの名前 (com1、com2 など) が含まれます。

pathnullです。

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

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。

path には、ファイル名、ディレクトリ名、またはボリューム ラベルの不正な構文または無効な構文が含まれています。

呼び出し元に、必要なアクセス許可がありません。

次のコード例は、このコンストラクターを示しています。

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);
            }
        }
    }
}

注釈

このコンストラクターは、 StreamWriter Byte-Order Mark (BOM) を使用せずに UTF-8 エンコードを使用して を作成するため、その GetPreamble メソッドは空のバイト配列を返します。 このコンストラクターの既定の UTF-8 エンコードでは、無効なバイトで例外がスローされます。 この動作は、 プロパティのエンコード オブジェクト Encoding.UTF8 によって提供される動作とは異なります。 BOM を指定し、無効なバイトで例外がスローされるかどうかを判断するには、 などの StreamWriter(String, Boolean, Encoding)エンコード オブジェクトをパラメーターとして受け入れるコンストラクターを使用します。

パラメーターには path 、汎用名前付け規則 (UNC) 共有上のファイルを含むファイル名を指定できます。 ファイルが存在する場合は上書きされます。それ以外の場合は、新しいファイルが作成されます。

パラメーターは path 、ディスクに格納されているファイルである必要はありません。ストリームを使用したアクセスをサポートするシステムの任意の部分を指定できます。

注意事項

特定のカルチャ設定で一連の文字をコンパイルし、異なるカルチャ設定を持つ同じ文字を取得すると、文字が解釈できず、例外がスローされる可能性があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

StreamWriter(Stream, Encoding)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

指定したエンコーディングと既定のバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。

public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding);

パラメーター

stream
Stream

書き込まれるストリーム。

encoding
Encoding

使用する文字エンコーディング。

例外

stream または encodingnull です。

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

次の例では、このコンストラクターを示します。

using System;
using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string fileName = "test.txt";
            string textToAdd = "Example text in file";
            FileStream fs = null;
            try
            {
               fs = new FileStream(fileName, FileMode.CreateNew);
               using (StreamWriter writer = new StreamWriter(fs, Encoding.Default))
                {
                    writer.Write(textToAdd);
                }
            }
            finally
            {
                if (fs != null)
                    fs.Dispose();
            }
        }
    }
}

注釈

このコンストラクターは、encoding パラメーターを Encoding 使用して プロパティを初期化し、stream パラメーターを BaseStream 使用して プロパティを初期化します。 ストリームの位置はリセットされません。 詳細については、「Encoding」を参照してください。

オブジェクトは StreamWriter 、 が呼び出 Dispose() されたときに、指定された Stream オブジェクトに対して StreamWriter.Dispose を呼び出します。

注意事項

特定のカルチャ設定で一連の文字をコンパイルし、異なるカルチャ設定で同じ文字を取得すると、文字が解釈できず、例外がスローされる可能性があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

StreamWriter(String, Boolean)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

既定のエンコーディングとバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。

public StreamWriter (string path, bool append);

パラメーター

path
String

書き込まれる完全なファイルパス。

append
Boolean

データをファイルに追加する場合は true、ファイルを上書きする場合は false。 指定されたファイルが存在しない場合、このパラメーターは無効であり、コンストラクターは新しいファイルを作成します。

例外

アクセスが拒否されました。

path が空です。

- または -

path には、システム デバイスの名前 (com1、com2 など) が含まれます。

pathnullです。

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

path には、ファイル名、ディレクトリ名、またはボリューム ラベルの不正な構文または無効な構文が含まれています。

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。

呼び出し元に、必要なアクセス許可がありません。

次のコード例は、このコンストラクターを示しています。

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);
            }
        }
    }
}

注釈

このコンストラクターは、 StreamWriter Byte-Order Mark (BOM) を使用せずに UTF-8 エンコードを使用して を作成するため、その GetPreamble メソッドは空のバイト配列を返します。 このコンストラクターの既定の UTF-8 エンコードでは、無効なバイトで例外がスローされます。 この動作は、 プロパティのエンコード オブジェクト Encoding.UTF8 によって提供される動作とは異なります。 BOM を指定し、無効なバイトで例外がスローされるかどうかを判断するには、 などの StreamWriter(String, Boolean, Encoding)エンコード オブジェクトをパラメーターとして受け入れるコンストラクターを使用します。

パラメーターには path 、汎用名前付け規則 (UNC) 共有上のファイルを含むファイル名を指定できます。

パラメーターは path 、ディスクに格納されているファイルである必要はありません。ストリームを使用したアクセスをサポートするシステムの任意の部分を指定できます。

注意事項

特定のカルチャ設定で一連の文字をコンパイルし、異なるカルチャ設定で同じ文字を取得すると、文字が解釈できず、例外がスローされる可能性があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

StreamWriter(String, FileStreamOptions)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

既定のエンコードを使用して、指定したオブジェクトで StreamWriter 構成された、指定したファイルの クラスの新しいインスタンスを FileStreamOptions 初期化します。

public StreamWriter (string path, System.IO.FileStreamOptions options);

パラメーター

path
String

書き込まれる完全なファイルパス。

options
FileStreamOptions

基になる FileStreamの構成オプションを指定する オブジェクト。

例外

options は です null

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

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET 6, 7, 8, 9

StreamWriter(Stream, Encoding, Int32)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

指定したエンコーディングとバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化します。

public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding, int bufferSize);

パラメーター

stream
Stream

書き込まれるストリーム。

encoding
Encoding

使用する文字エンコーディング。

bufferSize
Int32

バイト単位のバッファー サイズ。

例外

stream または encodingnull です。

bufferSize が負の値です。

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

次の例では、このコンストラクターを示します。

using System;
using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string fileName = "test.txt";
            string textToAdd = "Example text in file";
            FileStream fs = null;
            try
            {
                fs = new FileStream(fileName, FileMode.CreateNew);
                using (StreamWriter writer = new StreamWriter(fs, Encoding.UTF8, 512))
                {
                    writer.Write(textToAdd);
                }
            }
            finally
            {
                if (fs != null)
                    fs.Dispose();
            }
        }
    }
}

注釈

このコンストラクターは、 パラメーターを Encoding 使用して プロパティを encoding 初期化し、 パラメーターを BaseStream 使用して プロパティを stream 初期化します。 ストリームの位置はリセットされません。 詳細については、「Encoding」を参照してください。

オブジェクトは StreamWriter 、 が呼び出 Dispose() されたときに、指定された Stream オブジェクトに対して StreamWriter.Dispose を呼び出します。

注意事項

特定のカルチャ設定で一連の文字をコンパイルし、異なるカルチャ設定で同じ文字を取得すると、文字が解釈できず、例外がスローされる可能性があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

StreamWriter(String, Boolean, Encoding)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

指定したエンコーディングと既定のバッファー サイズを使用して、指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。

public StreamWriter (string path, bool append, System.Text.Encoding encoding);

パラメーター

path
String

書き込まれる完全なファイルパス。

append
Boolean

データをファイルに追加する場合は true、ファイルを上書きする場合は false。 指定されたファイルが存在しない場合、このパラメーターは無効であり、コンストラクターは新しいファイルを作成します。

encoding
Encoding

使用する文字エンコーディング。

例外

アクセスが拒否されました。

path が空です。

- または -

path には、システム デバイスの名前 (com1、com2 など) が含まれます。

pathnullです。

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

path には、ファイル名、ディレクトリ名、またはボリューム ラベルの不正な構文または無効な構文が含まれています。

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。

呼び出し元に、必要なアクセス許可がありません。

次の例では、このコンストラクターを示します。

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);
            }
        }
    }
}

注釈

このコンストラクターは、encoding パラメーターを Encoding 使用して プロパティを初期化します。 詳細については、「Encoding」を参照してください。

path には、汎用名前付け規則 (UNC) 共有上のファイルを含むファイル名を指定できます。

path は、ディスクに格納されているファイルである必要はありません。ストリーム経由のアクセスをサポートするシステムの任意の部分にすることができます。

注意事項

特定のカルチャ設定で一連の文字をコンパイルし、異なるカルチャ設定で同じ文字を取得すると、文字が解釈できず、例外がスローされる可能性があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

StreamWriter(String, Encoding, FileStreamOptions)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

指定したエンコーディングを使用して、指定したオブジェクトで StreamWriter 構成された、指定したファイルの クラスの新しいインスタンスを FileStreamOptions 初期化します。

public StreamWriter (string path, System.Text.Encoding encoding, System.IO.FileStreamOptions options);

パラメーター

path
String

書き込まれる完全なファイルパス。

encoding
Encoding

使用する文字エンコーディング。

options
FileStreamOptions

基になる FileStreamの構成オプションを指定する オブジェクト。

例外

options は です null

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

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET 6, 7, 8, 9

StreamWriter(Stream, Encoding, Int32, Boolean)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

指定した円コーディングとバッファー サイズを使用して、指定したストリーム用の StreamWriter クラスの新しいインスタンスを初期化し、必要に応じて、ストリームを開いたままにします。

public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding, int bufferSize, bool leaveOpen);
public StreamWriter (System.IO.Stream stream, System.Text.Encoding? encoding = default, int bufferSize = -1, bool leaveOpen = false);

パラメーター

stream
Stream

書き込まれるストリーム。

encoding
Encoding

使用する文字エンコーディング。

bufferSize
Int32

バイト単位のバッファー サイズ。

leaveOpen
Boolean

StreamWriter オブジェクトを破棄した後にストリームを開いたままにする場合は true、それ以外の場合は false

例外

stream または encodingnull です。

bufferSize が負の値です。

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

次の例では、このコンストラクターを示します。

using System;
using System.IO;
using System.Text;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string fileName = "test.txt";
            string textToAdd = "Example text in file";
            FileStream fs = null;
            try
            {
                fs = new FileStream(fileName, FileMode.CreateNew);
                using (StreamWriter writer = new StreamWriter(fs, Encoding.UTF8, 512, false))
                {
                    writer.Write(textToAdd);
                }
            }
            finally
            {
                if (fs != null)
                    fs.Dispose();
            }
        }
    }
}

注釈

パラメーターを にleaveOpentrue設定しない限り、 StreamWriter が呼び出されるとStreamWriter.Dispose、オブジェクトは指定されたStreamオブジェクトを呼び出Dispose()します。

このコンストラクターは、 パラメーターを Encoding 使用して プロパティを encoding 初期化し、 パラメーターを BaseStream 使用して プロパティを stream 初期化します。 ストリームの位置はリセットされません。 詳細については、 プロパティを Encoding 参照してください。

注意事項

特定のカルチャ設定で一連の文字をコンパイルし、異なるカルチャ設定で同じ文字を取得すると、文字が解釈できず、例外がスローされる可能性があります。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

StreamWriter(String, Boolean, Encoding, Int32)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

指定したエンコーディングとバッファー サイズを使用して、指定したパス上の指定したファイル用の StreamWriter クラスの新しいインスタンスを初期化します。 ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。

public StreamWriter (string path, bool append, System.Text.Encoding encoding, int bufferSize);

パラメーター

path
String

書き込まれる完全なファイルパス。

append
Boolean

データをファイルに追加する場合は true、ファイルを上書きする場合は false。 指定されたファイルが存在しない場合、このパラメーターは無効であり、コンストラクターは新しいファイルを作成します。

encoding
Encoding

使用する文字エンコーディング。

bufferSize
Int32

バイト単位のバッファー サイズ。

例外

path が空の文字列 ("") です。

- または -

path には、システム デバイスの名前 (com1、com2 など) が含まれます。

path または encodingnull です。

bufferSize が負の値です。

path には、ファイル名、ディレクトリ名、またはボリューム ラベルの不正な構文または無効な構文が含まれています。

呼び出し元に、必要なアクセス許可がありません。

アクセスが拒否されました。

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

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。

次の例では、このコンストラクターを示します。

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);
            }
        }
    }
}

注釈

このコンストラクターは、encoding パラメーターを Encoding 使用して プロパティを初期化します。 詳細については、「Encoding」を参照してください。

path には、汎用名前付け規則 (UNC) 共有上のファイルを含むファイル名を指定できます。

path は、ディスクに格納されているファイルである必要はありません。ストリーム経由のアクセスをサポートするシステムの任意の部分にすることができます。

注意事項

特定のカルチャ設定で一連の文字をコンパイルし、異なるカルチャ設定で同じ文字を取得すると、文字が解釈できず、例外がスローされる可能性があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1