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) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。

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

書き込む最大文字数。

例外

buffernullです。

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

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

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

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

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 から読み取られます。 基になるストリームの末尾に途中で到達しない限り、すべての文字が基になるストリームに書き込まれます。 AutoFlushtrueされている場合、Flush は自動的に呼び出されます。

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

こちらもご覧ください

適用対象

Write(String, ReadOnlySpan<Object>)

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

public:
 override void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public override void Write (string format, scoped ReadOnlySpan<object?> arg);
override this.Write : string * ReadOnlySpan<obj> -> unit
Public Overrides Sub Write (format As String, arg As ReadOnlySpan(Of Object))

パラメーター

format
String

複合書式指定文字列。

arg
ReadOnlySpan<Object>

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

適用対象

Write(String, Object[])

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

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

public:
 override void Write(System::String ^ value);
public override void Write (string value);
public override void Write (string? value);
override this.Write : string -> unit
Public Overrides Sub Write (value As String)

パラメーター

value
String

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

例外

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

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

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

注釈

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

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

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

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

こちらもご覧ください

適用対象

Write(Char[])

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

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

public:
 override void Write(cli::array <char> ^ buffer);
public override void Write (char[] buffer);
public override void Write (char[]? buffer);
override this.Write : char[] -> unit
Public Overrides Sub Write (buffer As Char())

パラメーター

buffer
Char[]

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

例外

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

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

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

注釈

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

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

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

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

こちらもご覧ください

適用対象

Write(Char)

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

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

例外

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

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

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

注釈

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

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

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

こちらもご覧ください

適用対象

Write(String, Object)

ソース:
StreamWriter.cs
ソース:
StreamWriter.cs
ソース:
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) を参照してください。

適用対象