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, Object[])

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

Write(Char[])

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

Write(String)

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

Write(ReadOnlySpan<Char>)

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

Write(Char)

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

Write(String, Object)

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

Write(String, Object, Object, Object)

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)

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

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

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 をオーバーライドします。

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

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

Write(String, Object[])

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(Char[])

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

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 をオーバーライドします。

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

この方法 Write char[],``int,``int では、チェックする引数が減るため、() よりもパフォーマンスが向上する場合があります。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

Write(String)

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

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 基になるストリームに書き込まれます。

Flush がの場合、は自動的に呼び出され AutoFlush true ます。 がの場合 value null 、エントリは書き込まれません。

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

Write(ReadOnlySpan<Char>)

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

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(Char)

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

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 をオーバーライドします。

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

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。

こちらもご覧ください

適用対象

Write(String, Object)

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)提供される複合書式指定機能の説明については、「」を参照してください。

適用対象