StreamWriter コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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
書き込まれるストリーム。
例外
stream
が書き込み可能ではありません。
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
はファイル名にすることもできます。
例外
アクセスが拒否されました。
path
が null
です。
指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。
指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。
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 マーク (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
使用する文字エンコーディング。
例外
stream
または encoding
が null
です。
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
。 指定されたファイルが存在しない場合、このパラメーターは無効であり、コンストラクターは新しいファイルを作成します。
例外
アクセスが拒否されました。
path
が null
です。
指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。
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 マーク (BOM) を使用せずに utf-8 エンコーディングを使用してを作成します。そのため、 GetPreamble メソッドは空のバイト配列を返します。 このコンストラクターの既定の UTF-8 エンコーディングでは、無効なバイトで例外がスローされます。 この動作は、プロパティの encoding オブジェクトによって提供される動作とは異なり Encoding.UTF8 ます。 BOM を指定し、無効なバイトに対して例外がスローされるかどうかを判断するには、などのパラメーターとしてエンコーディングオブジェクトを受け取るコンストラクターを使用し StreamWriter(String, Boolean, Encoding) ます。
パラメーターには、 path
汎用名前付け規則 (UNC) 共有上のファイルを含むファイル名を指定できます。
path
このパラメーターは、ディスクに格納されているファイルである必要はありません。ストリームを使用したアクセスをサポートするシステムの任意の部分を指定できます。
注意事項
特定のカルチャ設定を使用して文字セットをコンパイルし、異なるカルチャ設定で同じ文字を取得すると、文字が解釈されない可能性があり、例外がスローされる可能性があります。
共通 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 。
例外
options
が です null
。
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
バイト単位のバッファー サイズ。
例外
stream
または encoding
が null
です。
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 クラスの新しいインスタンスを初期化します。 ファイルが存在する場合は、ファイルを上書きするか、またはファイルの末尾に追加できます。 ファイルが存在しない場合は、このコンストラクターが新しいファイルを作成します。
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
が null
です。
指定されたパスが正しくありません (たとえば、マップされていないドライブにあるなど)。
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 (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 。
例外
options
が です null
。
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
。
例外
stream
または encoding
が null
です。
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
注釈
パラメーターを に設定しない限り、オブジェクトは が呼び出された場合に 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
データをファイルに追加する場合は true
、ファイルを上書きする場合は false
。 指定されたファイルが存在しない場合、このパラメーターは無効であり、コンストラクターは新しいファイルを作成します。
- encoding
- Encoding
使用する文字エンコーディング。
- bufferSize
- Int32
バイト単位のバッファー サイズ。
例外
path
または encoding
が null
です。
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 (Universal Naming Convention) 共有上のファイルを含むファイル名にできます。
path
は、ディスクに格納されているファイルである必要はありません。ストリーム経由のアクセスをサポートするシステムの任意の部分を指定できます。
注意事項
特定の文化的設定を使用して一連の文字をコンパイルし、異なる文化設定で同じ文字を取得すると、文字が解釈できない可能性があります。また、例外がスローされる可能性があります。
共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。