英語で読む

次の方法で共有


StreamWriter.Write メソッド

定義

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

オーバーロード

Write(String, Object, Object, Object)

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

Write(String, Object, Object)

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

Write(Char[], Int32, Int32)

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

Write(String, ReadOnlySpan<Object>)

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

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
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

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

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

パラメーター

format
String

複合書式指定文字列。

arg0
Object

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

arg1
Object

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

arg2
Object

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

注釈

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

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9

Write(String, Object, Object)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

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

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

パラメーター

format
String

複合書式指定文字列。

arg0
Object

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

arg1
Object

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

注釈

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

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9

Write(Char[], Int32, Int32)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

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

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

パラメーター

buffer
Char[]

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

index
Int32

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

count
Int32

書き込む最大文字数。

例外

buffernullです。

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

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

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

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

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

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

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

注釈

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

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

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

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Write(String, ReadOnlySpan<Object>)

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

C#
public override void Write (string format, scoped ReadOnlySpan<object?> arg);

パラメーター

format
String

複合書式指定文字列。

arg
ReadOnlySpan<Object>

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

適用対象

.NET 9
製品 バージョン
.NET 9

Write(String, Object[])

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

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

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

パラメーター

format
String

複合書式指定文字列。

arg
Object[]

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

注釈

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

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9

Write(ReadOnlySpan<Char>)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

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

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

パラメーター

buffer
ReadOnlySpan<Char>

書き込む文字スパン。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

Write(String)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

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

C#
public override void Write (string value);
C#
public override void Write (string? value);

パラメーター

value
String

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

例外

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

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

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

注釈

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

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

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

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

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Write(Char[])

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

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

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

パラメーター

buffer
Char[]

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

例外

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

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

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

注釈

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

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

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

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

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Write(Char)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

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

C#
public override void Write (char value);

パラメーター

value
Char

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

例外

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

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

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

注釈

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

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

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

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Write(String, Object)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
StreamWriter.cs

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

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

パラメーター

format
String

複合書式指定文字列。

arg0
Object

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

注釈

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

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9