StreamWriter StreamWriter StreamWriter StreamWriter Constructors

定義

オーバーロード

StreamWriter(Stream) StreamWriter(Stream) StreamWriter(Stream)

新しいインスタンスを初期化、 StreamWriter utf-8 エンコーディングと既定のバッファー サイズを使用して指定したストリーム用のクラス。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(String) StreamWriter(String) 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(Stream, Encoding) 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(String, Boolean) StreamWriter(String, Boolean) 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(Stream, Encoding, Int32) 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(String, Boolean, Encoding) 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(Stream, Encoding, Int32, Boolean) 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(String, Boolean, Encoding, Int32) 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) StreamWriter(Stream) StreamWriter(Stream)

新しいインスタンスを初期化、 StreamWriter utf-8 エンコーディングと既定のバッファー サイズを使用して指定したストリーム用のクラス。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 Stream Stream Stream

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

例外

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

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

注釈

このコンス トラクターを作成、 StreamWriter utf-8 エンコード付きでせずバイト オーダー マーク (BOM) ので、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プロパティ。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オブジェクト呼び出しDispose()提供されたStreamオブジェクトとStreamWriter.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(String) StreamWriter(String) 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 String String String

書き込むファイルの完全なパス。The complete file path to write to. path ファイル名であることができます。path can be a file name.

例外

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

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

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

注釈

このコンス トラクターを作成、 StreamWriter utf-8 エンコード付きでせずバイト オーダー マーク (BOM) ので、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プロパティ。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(Stream, Encoding) 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 Stream Stream Stream

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

encoding
Encoding Encoding 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エンコード パラメーターを使用してプロパティと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オブジェクト呼び出しDispose()提供されたStreamオブジェクトとStreamWriter.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(String, Boolean) StreamWriter(String, Boolean) 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 String String String

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

append
Boolean Boolean Boolean Boolean

true データは、ファイルを追加するにはfalseファイルを上書きします。true 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.

例外

path が空です。path is empty.

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

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

注釈

このコンス トラクターを作成、 StreamWriter utf-8 エンコード付きでせずバイト オーダー マーク (BOM) ので、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プロパティ。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(Stream, Encoding, Int32) 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 Stream Stream Stream

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

encoding
Encoding Encoding Encoding Encoding

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

bufferSize
Int32 Int32 Int32 Int32

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

例外

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.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パラメーター。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オブジェクト呼び出しDispose()提供されたStreamオブジェクトとStreamWriter.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(String, Boolean, Encoding) 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 String String String

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

append
Boolean Boolean Boolean Boolean

true データは、ファイルを追加するにはfalseファイルを上書きします。true 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 Encoding Encoding Encoding

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

例外

path が空です。path is empty.

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

指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。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エンコード パラメーターを使用するプロパティ。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(Stream, Encoding, Int32, Boolean) 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, int bufferSize, bool leaveOpen);
new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int * bool -> System.IO.StreamWriter

パラメーター

stream
Stream Stream Stream Stream

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

encoding
Encoding Encoding Encoding Encoding

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

bufferSize
Int32 Int32 Int32 Int32

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

leaveOpen
Boolean Boolean Boolean Boolean

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

例外

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.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パラメーターをtrueStreamWriterオブジェクト呼び出しDispose()提供されたStreamオブジェクトとStreamWriter.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パラメーター、および初期化、BaseStreamプロパティを使用して、streamパラメーター。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(String, Boolean, Encoding, Int32) 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 String String String

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

append
Boolean Boolean Boolean Boolean

true データは、ファイルを追加するにはfalseファイルを上書きします。true 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 Encoding Encoding Encoding

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

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

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 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エンコード パラメーターを使用するプロパティ。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

こちらもご覧ください

適用対象