次の方法で共有


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);
public StreamWriter (System.IO.Stream stream);
new System.IO.StreamWriter : System.IO.Stream -> System.IO.StreamWriter
Public Sub New (stream As 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();
            }
        }
    }
}
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 はファイル名にすることもできます。

例外

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

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

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

例外

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();
            }
        }
    }
}
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。 指定されたファイルが存在しない場合、このパラメーターは無効であり、コンストラクターは新しいファイルを作成します。

例外

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

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);
            }
        }
    }
}
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) 共有上のファイルを含むファイル名を指定できます。

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

注意事項

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

共通 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の構成オプションを指定する オブジェクト。

例外

options は です null

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

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

例外

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

データをファイルに追加する場合は 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);
            }
        }
    }
}
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の構成オプションを指定する オブジェクト。

例外

options は です null

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

例外

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

データをファイルに追加する場合は 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);
            }
        }
    }
}
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) 共有上のファイルを含むファイル名を指定できます。

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

注意事項

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

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

こちらもご覧ください

適用対象