StreamWriter.Write メソッド

定義

名前空間:

System.IO

アセンブリ:

System.Runtime.dll

ストリームにデータを書き込みます。

オーバーロード

Write(String, Object, Object, Object)	Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。
Write(String, Object, Object)	Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。
Write(Char[], Int32, Int32)	ストリームに文字のサブ配列を書き込みます。
Write(String, Object[])	Format(String, Object[]) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。
Write(ReadOnlySpan<Char>)	ストリームに文字スパンを書き込みます。
Write(String)	ストリームに文字列を書き込みます。
Write(Char[])	ストリームに文字配列を書き込みます。
Write(Char)	ストリームに文字を書き込みます。
Write(String, Object)	Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。

Write(String, Object, Object, Object)

ソース:

StreamWriter.cs

Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public override void Write (string format, object? arg0, object? arg1, object? arg2);

override this.Write : string * obj * obj * obj -> unit

Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

パラメーター

format

String

複合書式指定文字列。

arg0

Object

書式設定と書き込みを行う最初のオブジェクト。

arg1

Object

書式設定と書き込みを行う 2 番目のオブジェクト。

arg2

Object

書式設定と書き込みを行う 3 番目のオブジェクト。

注釈

提供される複合書式設定機能の説明については、Write(String, Object, Object, Object) を参照してください。

Write(String, Object, Object)

ソース:

StreamWriter.cs

Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public override void Write (string format, object? arg0, object? arg1);

override this.Write : string * obj * obj -> unit

Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object)

パラメーター

format

String

複合書式指定文字列。

arg0

Object

書式設定と書き込みを行う最初のオブジェクト。

arg1

Object

書式設定と書き込みを行う 2 番目のオブジェクト。

注釈

提供される複合書式設定機能の説明については、Write(String, Object, Object) を参照してください。

Write(Char[], Int32, Int32)

ソース:

StreamWriter.cs

ストリームに文字のサブ配列を書き込みます。

public:
 override void Write(cli::array <char> ^ buffer, int index, int count);

public override void Write (char[] buffer, int index, int count);

override this.Write : char[] * int * int -> unit

Public Overrides Sub Write (buffer As Char(), index As Integer, count As Integer)

パラメーター

buffer

Char[]

書き込むデータを含む文字配列。

index

Int32

データの読み取りを開始するバッファー内の文字位置。

count

Int32

書き込む最大文字数。

例外

ArgumentNullException

buffer は nullです。

ArgumentException

バッファーの長さから index を引いた値は、count未満です。

ArgumentOutOfRangeException

index または count は負の値です。

IOException

I/O エラーが発生しました。

ObjectDisposedException

AutoFlush が true であるか、StreamWriter バッファーがいっぱいで、現在のライターが閉じられています。

NotSupportedException

AutoFlush が true であるか、StreamWriter バッファーがいっぱいであり、StreamWriter がストリームの末尾にあるため、バッファーの内容を基になる固定サイズ ストリームに書き込むことができません。

例

次の使用例は、配列の 3 番目の要素から始まる 13 要素の配列から 8 文字をファイルに書き込みます。

using namespace System;
using namespace System::IO;

int main()
{
   FileStream^ sb = gcnew FileStream( "MyFile.txt",FileMode::OpenOrCreate );
   array<Char>^b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
   StreamWriter^ sw = gcnew StreamWriter( sb );
   sw->Write( b, 3, 8 );
   sw->Close();
}

using System;
using System.IO;

public class SWBuff
{
    public static void Main(String[] args)
    {
        FileStream sb = new FileStream("MyFile.txt", FileMode.OpenOrCreate);
        char[] b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
        StreamWriter sw = new StreamWriter(sb);
        sw.Write(b, 3, 8);
        sw.Close();
    }
}

Imports System.IO

Public Class SWBuff

    Public Shared Sub Main()
        Dim sb As New FileStream("MyFile.txt", FileMode.OpenOrCreate)
        Dim b As Char() = {"a"c, "b"c, "c"c, "d"c, "e"c, "f"c, "g"c, _
           "h"c, "i"c, "j"c, "k"c, "l"c, "m"c}
        Dim sw As New StreamWriter(sb)
        sw.Write(b, 3, 8)
        sw.Close()
    End Sub
End Class

注釈

このメソッドは、TextWriter.Writeをオーバーライドします。

文字は、index から始まり、index + (count - 1) まで続く buffer から読み取られます。 基になるストリームの末尾に途中で到達しない限り、すべての文字が基になるストリームに書き込まれます。 AutoFlush が trueされている場合、Flush は自動的に呼び出されます。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(String, Object[])

ソース:

StreamWriter.cs

Format(String, Object[]) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。

public:
 override void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public override void Write (string format, params object?[] arg);

override this.Write : string * obj[] -> unit

Public Overrides Sub Write (format As String, ParamArray arg As Object())

パラメーター

format

String

複合書式指定文字列。

arg

Object[]

書式設定と書き込みを行う 0 個以上のオブジェクトを含むオブジェクト配列。

注釈

提供される複合書式設定機能の説明については、Write(String, Object[]) を参照してください。

Write(ReadOnlySpan<Char>)

ソース:

StreamWriter.cs

ストリームに文字スパンを書き込みます。

public:
 override void Write(ReadOnlySpan<char> buffer);

public override void Write (ReadOnlySpan<char> buffer);

override this.Write : ReadOnlySpan<char> -> unit

Public Overrides Sub Write (buffer As ReadOnlySpan(Of Char))

パラメーター

buffer

ReadOnlySpan<Char>

書き込む文字スパン。

Write(String)

ソース:

StreamWriter.cs

ストリームに文字列を書き込みます。

public:
 override void Write(System::String ^ value);

public override void Write (string? value);

override this.Write : string -> unit

Public Overrides Sub Write (value As String)

パラメーター

value

String

ストリームに書き込む文字列。 value が null の場合、何も書き込まれありません。

例外

ObjectDisposedException

AutoFlush が true であるか、StreamWriter バッファーがいっぱいで、現在のライターが閉じられています。

NotSupportedException

AutoFlush が true であるか、StreamWriter バッファーがいっぱいであり、StreamWriter がストリームの末尾にあるため、バッファーの内容を基になる固定サイズ ストリームに書き込むことができません。

IOException

I/O エラーが発生しました。

注釈

このメソッドは、TextWriter.Writeをオーバーライドします。

指定した String は、ストリームの末尾に途中で到達しない限り、基になるストリームに書き込まれます。

AutoFlush が trueされている場合、Flush は自動的に呼び出されます。 value が nullされている場合、エントリは書き込まれなくなります。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(Char[])

ソース:

StreamWriter.cs

ストリームに文字配列を書き込みます。

public:
 override void Write(cli::array <char> ^ buffer);

public override void Write (char[]? buffer);

override this.Write : char[] -> unit

Public Overrides Sub Write (buffer As Char())

パラメーター

buffer

Char[]

書き込むデータを含む文字配列。 buffer が nullされている場合、何も書き込まれます。

例外

IOException

I/O エラーが発生しました。

ObjectDisposedException

AutoFlush が true であるか、StreamWriter バッファーがいっぱいで、現在のライターが閉じられています。

NotSupportedException

AutoFlush が true であるか、StreamWriter バッファーがいっぱいであり、StreamWriter がストリームの末尾にあるため、バッファーの内容を基になる固定サイズ ストリームに書き込むことができません。

注釈

このメソッドは、TextWriter.Writeをオーバーライドします。

指定された文字は、ストリームの末尾に途中で到達しない限り、基になるストリームに書き込まれます。 AutoFlush が trueされると、Flush が自動的に呼び出されます。

このメソッドは、チェックする引数が少ないため、Write (char[],``int,``int) よりも高速なパフォーマンスを提供できます。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(Char)

ソース:

StreamWriter.cs

ストリームに文字を書き込みます。

public:
 override void Write(char value);

public override void Write (char value);

override this.Write : char -> unit

Public Overrides Sub Write (value As Char)

パラメーター

value

Char

ストリームに書き込む文字。

例外

IOException

I/O エラーが発生しました。

ObjectDisposedException

AutoFlush が true であるか、StreamWriter バッファーがいっぱいで、現在のライターが閉じられています。

NotSupportedException

AutoFlush が true であるか、StreamWriter バッファーがいっぱいであり、StreamWriter がストリームの末尾にあるため、バッファーの内容を基になる固定サイズ ストリームに書き込むことができません。

注釈

このメソッドは、TextWriter.Writeをオーバーライドします。

指定された文字は、ストリームの末尾に途中で到達しない限り、基になるストリームに書き込まれます。 AutoFlush が trueされると、Flush が自動的に呼び出されます。

一般的な I/O タスクの一覧については、「一般的な I/O タスクの」を参照してください。

こちらもご覧ください

• ファイルおよびストリーム I/O
• 方法: ファイル からテキストを読み取る
• 方法: ファイル にテキストを書き込む

Write(String, Object)

ソース:

StreamWriter.cs

Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。

public:
 override void Write(System::String ^ format, System::Object ^ arg0);

public override void Write (string format, object? arg0);

override this.Write : string * obj -> unit

Public Overrides Sub Write (format As String, arg0 As Object)

パラメーター

format

String

複合書式指定文字列。

arg0

Object

書式設定および書き込み対象のオブジェクト。

注釈

提供される複合書式設定機能の説明については、Write(String, Object) を参照してください。