StreamWriter コンストラクター

リファレンス

定義

名前空間:: System.IO

アセンブリ:: System.IO.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: netstandard.dll

アセンブリ:: System.Runtime.Extensions.dll

アセンブリ:: mscorlib.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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)

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

public:
 StreamWriter(System::IO::Stream ^ stream);

public StreamWriter (System.IO.Stream stream);

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

Public Sub New (stream As Stream)

パラメーター

stream: Stream

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

例外

ArgumentException

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

ArgumentNullException

stream が nullです。

例

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

using System;
using System.IO;

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

Imports System.IO

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"
        Dim fs As FileStream = Nothing
        Try
            fs = New FileStream(fileName, FileMode.CreateNew)
            Using writer As StreamWriter = New StreamWriter(fs)
                writer.Write(textToAdd)
            End Using
        Finally
            If Not fs Is Nothing Then
                fs.Dispose()
            End If
        End Try
    End Sub

End Module

注釈

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

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

注意事項

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

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

こちらもご覧ください

適用対象

StreamWriter(String)

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

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

public StreamWriter (string path);

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

Public Sub New (path As String)

パラメーター

path: String

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

例外

UnauthorizedAccessException

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

ArgumentException

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

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

ArgumentNullException

path が nullです。

DirectoryNotFoundException

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

PathTooLongException

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

IOException

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

SecurityException

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

例

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

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string fileName = "test.txt";
            string textToAdd = "Example text in file";

            using (StreamWriter writer = new StreamWriter(fileName))
            {
                writer.Write(textToAdd);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"

        Using writer As StreamWriter = New StreamWriter(fileName)
            writer.Write(textToAdd)
        End Using
    End Sub

End Module

注釈

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

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

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

注意事項

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

こちらもご覧ください

適用対象

StreamWriter(Stream, Encoding)

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

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

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

new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding -> System.IO.StreamWriter

Public Sub New (stream As Stream, encoding As Encoding)

パラメーター

stream: Stream

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

encoding: Encoding

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

例外

ArgumentNullException

stream または encoding が null です。

ArgumentException

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

例

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

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

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

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"
        Dim fs As FileStream = Nothing
        Try
            fs = New FileStream(fileName, FileMode.CreateNew)
            Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default)
                writer.Write(textToAdd)
            End Using
        Finally
            If Not fs Is Nothing Then
                fs.Dispose()
            End If
        End Try
    End Sub

End Module

注釈

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

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

注意事項

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

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

こちらもご覧ください

適用対象

StreamWriter(String, Boolean)

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

public:
 StreamWriter(System::String ^ path, bool append);

public StreamWriter (string path, bool append);

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

Public Sub New (path As String, append As Boolean)

パラメーター

path: String

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

append: Boolean

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

例外

UnauthorizedAccessException

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

ArgumentException

path が空です。

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

ArgumentNullException

path が nullです。

DirectoryNotFoundException

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

IOException

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

PathTooLongException

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

SecurityException

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

例

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

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string fileName = "test.txt";
            string textToAdd = "Example text in file";

            using (StreamWriter writer = new StreamWriter(fileName, true))
            {
                writer.Write(textToAdd);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"

        Using writer As StreamWriter = New StreamWriter(fileName, True)
            writer.Write(textToAdd)
        End Using
    End Sub

End Module

注釈

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

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

注意事項

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

こちらもご覧ください

適用対象

StreamWriter(String, FileStreamOptions)

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

public:
 StreamWriter(System::String ^ path, System::IO::FileStreamOptions ^ options);

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

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

Public Sub New (path As String, options As FileStreamOptions)

パラメーター

path: String

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

options: FileStreamOptions

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

例外

ArgumentNullException

options がです null 。

ArgumentException

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

こちらもご覧ください

適用対象

StreamWriter(Stream, Encoding, Int32)

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

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

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

new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int -> System.IO.StreamWriter

Public Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer)

パラメーター

stream: Stream

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

encoding: Encoding

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

bufferSize: Int32

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

例外

ArgumentNullException

stream または encoding が null です。

ArgumentOutOfRangeException

bufferSize が負の値です。

ArgumentException

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

例

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

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

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

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"
        Dim fs As FileStream = Nothing
        Try
            fs = New FileStream(fileName, FileMode.CreateNew)
            Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default, 512)
                writer.Write(textToAdd)
            End Using
        Finally
            If Not fs Is Nothing Then
                fs.Dispose()
            End If
        End Try
    End Sub

End Module

注釈

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

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

注意事項

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

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

こちらもご覧ください

適用対象

StreamWriter(String, Boolean, Encoding)

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

public:
 StreamWriter(System::String ^ path, bool append, System::Text::Encoding ^ encoding);

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

new System.IO.StreamWriter : string * bool * System.Text.Encoding -> System.IO.StreamWriter

Public Sub New (path As String, append As Boolean, encoding As Encoding)

パラメーター

path: String

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

append: Boolean

encoding: Encoding

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

例外

UnauthorizedAccessException

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

ArgumentException

path が空です。

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

ArgumentNullException

path が nullです。

DirectoryNotFoundException

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

IOException

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

PathTooLongException

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

SecurityException

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

例

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

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string fileName = "test.txt";
            string textToAdd = "Example text in file";

            using (StreamWriter writer = new StreamWriter(fileName, true, Encoding.UTF8))
            {
                writer.Write(textToAdd);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"

        Using writer As StreamWriter = New StreamWriter(fileName, True, Encoding.UTF8)
            writer.Write(textToAdd)
        End Using
    End Sub

End Module

注釈

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

path は、UNC (Universal Naming Convention) 共有上のファイルを含むファイル名にできます。

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

注意事項

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

こちらもご覧ください

適用対象

StreamWriter(String, Encoding, FileStreamOptions)

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

public:
 StreamWriter(System::String ^ path, System::Text::Encoding ^ encoding, System::IO::FileStreamOptions ^ options);

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

new System.IO.StreamWriter : string * System.Text.Encoding * System.IO.FileStreamOptions -> System.IO.StreamWriter

Public Sub New (path As String, encoding As Encoding, options As FileStreamOptions)

パラメーター

path: String

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

encoding: Encoding

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

options: FileStreamOptions

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

例外

ArgumentNullException

options がです null 。

ArgumentException

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

こちらもご覧ください

適用対象

StreamWriter(Stream, Encoding, Int32, Boolean)

指定した円コーディングとバッファーサイズを使用して、指定したストリーム用の 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, int bufferSize, bool leaveOpen);

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

new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int * bool -> System.IO.StreamWriter

Public Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer, leaveOpen As Boolean)

Public Sub New (stream As Stream, Optional encoding As Encoding = Nothing, Optional bufferSize As Integer = -1, Optional leaveOpen As Boolean = false)

パラメーター

stream: Stream

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

encoding: Encoding

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

bufferSize: Int32

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

leaveOpen: Boolean

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

例外

ArgumentNullException

stream または encoding が null です。

ArgumentOutOfRangeException

bufferSize が負の値です。

ArgumentException

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

例

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

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

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

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"
        Dim fs As FileStream = Nothing
        Try
            fs = New FileStream(fileName, FileMode.CreateNew)
            Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default, 512, False)
                writer.Write(textToAdd)
            End Using
        Finally
            If Not fs Is Nothing Then
                fs.Dispose()
            End If
        End Try
    End Sub

End Module

注釈

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

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

注意事項

適用対象

StreamWriter(String, Boolean, Encoding, Int32)

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

public:
 StreamWriter(System::String ^ path, bool append, System::Text::Encoding ^ encoding, int bufferSize);

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

new System.IO.StreamWriter : string * bool * System.Text.Encoding * int -> System.IO.StreamWriter

Public Sub New (path As String, append As Boolean, encoding As Encoding, bufferSize As Integer)

パラメーター

path: String

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

append: Boolean

encoding: Encoding

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

bufferSize: Int32

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

例外

ArgumentException

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

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

ArgumentNullException

path または encoding が null です。

ArgumentOutOfRangeException

bufferSize が負の値です。

IOException

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

SecurityException

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

UnauthorizedAccessException

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

DirectoryNotFoundException

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

PathTooLongException

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

例

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

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string fileName = "test.txt";
            string textToAdd = "Example text in file";

            using (StreamWriter writer = new StreamWriter(fileName, true, Encoding.UTF8, 512))
            {
                writer.Write(textToAdd);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"

        Using writer As StreamWriter = New StreamWriter(fileName, True, Encoding.UTF8, 512)
            writer.Write(textToAdd)
        End Using
    End Sub

End Module

注釈

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

path は、UNC (Universal Naming Convention) 共有上のファイルを含むファイル名にできます。

注意事項

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

こちらもご覧ください

適用対象

StreamWriter コンストラクター

定義

オーバーロード

StreamWriter(Stream)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

StreamWriter(String)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

StreamWriter(Stream, Encoding)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

StreamWriter(String, Boolean)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

StreamWriter(String, FileStreamOptions)

パラメーター

例外

こちらもご覧ください

適用対象

StreamWriter(Stream, Encoding, Int32)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

StreamWriter(String, Boolean, Encoding)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

StreamWriter(String, Encoding, FileStreamOptions)

パラメーター

例外

こちらもご覧ください

適用対象

StreamWriter(Stream, Encoding, Int32, Boolean)

パラメーター

例外

例

注釈

適用対象

StreamWriter(String, Boolean, Encoding, Int32)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース