StreamWriter.Write メソッド

定義

ストリームにデータを書き込みます。Writes data to the stream.

オーバーロード

Write(String, Object, Object, Object)

Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。Writes a formatted string to the stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, Object, Object)

Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。Writes a formatted string to the stream using the same semantics as the Format(String, Object, Object) method..

Write(Char[], Int32, Int32)

ストリームに文字配列の一部を書き込みます。Writes a subarray of characters to the stream.

Write(String, Object[])

Format(String, Object[]) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。Writes a formatted string to the stream, using the same semantics as the Format(String, Object[]) method.

Write(ReadOnlySpan<Char>)

文字スパンをストリームに書き込みます。Writes a character span to the stream.

Write(String)

ストリームに文字列を書き込みます。Writes a string to the stream.

Write(Char[])

ストリームに文字配列を書き込みます。Writes a character array to the stream.

Write(Char)

ストリームに文字を書き込みます。Writes a character to the stream.

Write(String, Object)

Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。Writes a formatted string to the stream, using the same semantics as the Format(String, Object) method.

Write(String, Object, Object, Object)

Format(String, Object, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。Writes a formatted string to the stream, using the same semantics as the Format(String, Object, Object, Object) method.

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

複合書式設定文字列。A composite format string.

arg0
Object

書式設定および書き込みをする最初のオブジェクト。The first object to format and write.

arg1
Object

書式設定および書き込みをする 2 番目のオブジェクト。The second object to format and write.

arg2
Object

書式設定および書き込みをする 3 番目のオブジェクト。The third object to format and write.

注釈

提供される複合書式指定機能の説明については、「Write(String, Object, Object, Object)」を参照してください。See Write(String, Object, Object, Object) for a description of the composite formatting capabilities offered.

Write(String, Object, Object)

Format(String, Object, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。Writes a formatted string to the stream using the same semantics as the Format(String, Object, Object) method..

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

複合書式設定文字列。A composite format string.

arg0
Object

書式設定および書き込みをする最初のオブジェクト。The first object to format and write.

arg1
Object

書式設定および書き込みをする 2 番目のオブジェクト。The second object to format and write.

注釈

提供される複合書式指定機能の説明については、「Write(String, Object, Object)」を参照してください。See Write(String, Object, Object) for a description of the composite formatting capabilities offered.

Write(Char[], Int32, Int32)

ストリームに文字配列の一部を書き込みます。Writes a subarray of characters to the stream.

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[]

書き込むデータを格納する文字配列。A character array that contains the data to write.

index
Int32

データの読み取りを開始する、バッファー内の文字位置。The character position in the buffer at which to start reading data.

count
Int32

書き込む文字の最大数。The maximum number of characters to write.

例外

buffernull です。buffer is null.

バッファーの長さから index を引いた値が count 未満です。The buffer length minus index is less than count.

index または count が負の値です。index or count is negative.

I/O エラーが発生します。An I/O error occurs.

AutoFlush が true または StreamWriter バッファーがいっぱいで、現在のライターが閉じられています。AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush が true または StreamWriter バッファーがいっぱいで、StreamWriter がストリームの末尾にあるため、基になる固定サイズのストリームにバッファーの内容を書き込むことができません。AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

この例では、配列の3番目の要素を開始位置として、13個の要素から成る配列の8文字をファイルに書き込みます。This example writes eight characters from a 13-element array to a file, beginning at the third element of the array.

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 をオーバーライドします。This method overrides TextWriter.Write.

これらの文字は、index から開始し、index + (count-1) を続ける buffer から読み取られます。The characters are read from buffer beginning at index and continuing through index + (count - 1). 基になるストリームの末尾に到達しない限り、すべての文字が基になるストリームに書き込まれます。All characters are written to the underlying stream unless the end of the underlying stream is reached prematurely. AutoFlushtrue場合は、Flush が自動的に呼び出されます。Flush is invoked automatically if AutoFlush is true.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

Write(String, Object[])

Format(String, Object[]) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。Writes a formatted string to the stream, using the same semantics as the Format(String, Object[]) method.

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

複合書式設定文字列。A composite format string.

arg
Object[]

書式設定および書き込みをする 0 個以上のオブジェクトを含むオブジェクト配列。An object array that contains zero or more objects to format and write.

注釈

提供される複合書式指定機能の説明については、「Write(String, Object[])」を参照してください。See Write(String, Object[]) for a description of the composite formatting capabilities offered.

Write(ReadOnlySpan<Char>)

文字スパンをストリームに書き込みます。Writes a character span to the stream.

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>

書き込む文字スパン。The character span to write.

Write(String)

ストリームに文字列を書き込みます。Writes a string to the stream.

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

ストリームに書き込む文字列。The string to write to the stream. value が null の場合は、何も書き込まれません。If value is null, nothing is written.

例外

AutoFlush が true または StreamWriter バッファーがいっぱいで、現在のライターが閉じられています。AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush が true または StreamWriter バッファーがいっぱいで、StreamWriter がストリームの末尾にあるため、基になる固定サイズのストリームにバッファーの内容を書き込むことができません。AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

I/O エラーが発生します。An I/O error occurs.

注釈

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

ストリームの末尾に到達しない限り、指定された String は基になるストリームに書き込まれます。The specified String is written to the underlying stream unless the end of the stream is reached prematurely.

AutoFlushtrue場合は、Flush が自動的に呼び出されます。Flush is invoked automatically if AutoFlush is true. valuenull場合、エントリは書き込まれません。If value is null, no entries are written.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

Write(Char[])

ストリームに文字配列を書き込みます。Writes a character array to the stream.

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[]

書き込むデータを格納する文字配列。A character array containing the data to write. buffernull の場合は、何も書き込まれません。If buffer is null, nothing is written.

例外

I/O エラーが発生します。An I/O error occurs.

AutoFlush が true または StreamWriter バッファーがいっぱいで、現在のライターが閉じられています。AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush が true または StreamWriter バッファーがいっぱいで、StreamWriter がストリームの末尾にあるため、基になる固定サイズのストリームにバッファーの内容を書き込むことができません。AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

注釈

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

ストリームの末尾に到達しない限り、指定した文字が基になるストリームに書き込まれます。The specified characters are written to the underlying stream unless the end of the stream is reached prematurely. AutoFlushtrue場合、Flush は自動的に呼び出されます。If AutoFlush is true, Flush is invoked automatically.

この方法では、チェックする引数が少数であるため Write (char[],``int,``int) よりもパフォーマンスが向上する場合があります。This method might provide faster performance than Write (char[],``int,``int) because it has fewer arguments to check.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

Write(Char)

ストリームに文字を書き込みます。Writes a character to the stream.

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

ストリームに書き込む文字。The character to write to the stream.

例外

I/O エラーが発生します。An I/O error occurs.

AutoFlush が true または StreamWriter バッファーがいっぱいで、現在のライターが閉じられています。AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

AutoFlush が true または StreamWriter バッファーがいっぱいで、StreamWriter がストリームの末尾にあるため、基になる固定サイズのストリームにバッファーの内容を書き込むことができません。AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

注釈

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

ストリームの末尾に到達しない限り、指定した文字が基になるストリームに書き込まれます。The specified character is written to the underlying stream unless the end of the stream is reached prematurely. AutoFlushtrue場合、Flush は自動的に呼び出されます。If AutoFlush is true, Flush is invoked automatically.

共通 I/O タスクの一覧は、 共通 I/O タスク を参照してください。For a list of common I/O tasks, see Common I/O Tasks.

こちらもご覧ください

Write(String, Object)

Format(String, Object) メソッドと同じセマンティクスを使用して、書式設定された文字列をストリームに書き込みます。Writes a formatted string to the stream, using the same semantics as the Format(String, Object) method.

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

複合書式設定文字列。A composite format string.

arg0
Object

書式設定および書き込みをするオブジェクト。The object to format and write.

注釈

提供される複合書式指定機能の説明については、「Write(String, Object)」を参照してください。See Write(String, Object) for a description of the composite formatting capabilities offered.

適用対象