StreamWriter コンストラクター

リファレンス

定義

名前空間:: System.IO

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

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

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

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.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)

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

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

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

注意事項

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

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

こちらもご覧ください

適用対象

StreamWriter(String)

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

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

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

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

注意事項

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

こちらもご覧ください

適用対象

StreamWriter(Stream, Encoding)

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

指定したエンコーディングと既定のバッファーサイズを使用して、指定したストリーム用の 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 使用してプロパティを初期化し、stream パラメーターを BaseStream 使用してプロパティを初期化します。ストリームの位置はリセットされません。詳細については、「Encoding」を参照してください。

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

注意事項

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

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

こちらもご覧ください

適用対象

StreamWriter(String, Boolean)

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

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

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

注意事項

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

こちらもご覧ください

適用対象

StreamWriter(String, FileStreamOptions)

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

既定のエンコードを使用して、指定したオブジェクトで 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.cs

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

指定したエンコーディングとバッファーサイズを使用して、指定したストリーム用の 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.cs

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

指定したエンコーディングと既定のバッファーサイズを使用して、指定したファイル用の 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) 共有上のファイルを含むファイル名を指定できます。

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

注意事項

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

こちらもご覧ください

適用対象

StreamWriter(String, Encoding, FileStreamOptions)

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

指定したエンコーディングを使用して、指定したオブジェクトで 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.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, 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

注釈

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

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

注意事項

適用対象

StreamWriter(String, Boolean, Encoding, Int32)

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

ソース:: StreamWriter.cs

指定したエンコーディングとバッファーサイズを使用して、指定したパス上の指定したファイル用の 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) 共有上のファイルを含むファイル名を指定できます。

注意事項

共通 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)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース