StreamWriter.Write Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Menulis data ke aliran.

Overload

Write(String, Object, Object, Object)	Menulis string yang diformat ke aliran, menggunakan semantik yang sama dengan metode Format(String, Object, Object, Object).
Write(String, Object, Object)	Menulis string yang diformat ke aliran menggunakan semantik yang sama dengan metode Format(String, Object, Object).
Write(Char[], Int32, Int32)	Menulis subarray karakter ke aliran.
Write(String, Object[])	Menulis string yang diformat ke aliran, menggunakan semantik yang sama dengan metode Format(String, Object[]).
Write(ReadOnlySpan<Char>)	Menulis rentang karakter ke aliran.
Write(String)	Menulis string ke aliran.
Write(Char[])	Menulis array karakter ke aliran.
Write(Char)	Menulis karakter ke aliran.
Write(String, Object)	Menulis string yang diformat ke aliran, menggunakan semantik yang sama dengan metode Format(String, Object).

Write(String, Object, Object, Object)

Sumber:

StreamWriter.cs

Menulis string yang diformat ke aliran, menggunakan semantik yang sama dengan metode 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)

Parameter

format

String

String format komposit.

arg0

Object

Objek pertama yang diformat dan ditulis.

arg1

Object

Objek kedua untuk memformat dan menulis.

arg2

Object

Objek ketiga yang akan diformat dan ditulis.

Keterangan

Lihat Write(String, Object, Object, Object) untuk deskripsi kemampuan pemformatan komposit yang ditawarkan.

Write(String, Object, Object)

Sumber:

StreamWriter.cs

Menulis string yang diformat ke aliran menggunakan semantik yang sama dengan metode 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)

Parameter

format

String

String format komposit.

arg0

Object

Objek pertama yang diformat dan ditulis.

arg1

Object

Objek kedua untuk memformat dan menulis.

Keterangan

Lihat Write(String, Object, Object) untuk deskripsi kemampuan pemformatan komposit yang ditawarkan.

Write(Char[], Int32, Int32)

Sumber:

StreamWriter.cs

Menulis subarray karakter ke aliran.

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)

Parameter

buffer

Char[]

Array karakter yang berisi data yang akan ditulis.

index

Int32

Posisi karakter dalam buffer untuk mulai membaca data.

count

Int32

Jumlah maksimum karakter yang akan ditulis.

Pengecualian

ArgumentNullException

buffer null.

ArgumentException

Panjang buffer dikurangi index kurang dari count.

ArgumentOutOfRangeException

index atau count negatif.

IOException

Terjadi kesalahan I/O.

ObjectDisposedException

AutoFlush benar atau buffer StreamWriter penuh, dan penulis saat ini ditutup.

NotSupportedException

AutoFlush benar atau buffer StreamWriter penuh, dan konten buffer tidak dapat ditulis ke aliran ukuran tetap yang mendasar karena StreamWriter berada di akhir aliran.

Contoh

Contoh ini menulis delapan karakter dari array 13 elemen ke file, dimulai dari elemen ketiga 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

Keterangan

Metode ini mengambil alih TextWriter.Write.

Karakter dibaca dari buffer dimulai pada index dan melanjutkan melalui index + (count - 1). Semua karakter ditulis ke aliran yang mendasarinya kecuali akhir aliran yang mendasarinya tercapai sebelum waktunya. Flush dipanggil secara otomatis jika AutoFlushtrue.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• I/O File dan Stream
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

Write(String, Object[])

Sumber:

StreamWriter.cs

Menulis string yang diformat ke aliran, menggunakan semantik yang sama dengan metode 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())

Parameter

format

String

String format komposit.

arg

Object[]

Array objek yang berisi nol atau lebih objek untuk diformat dan ditulis.

Keterangan

Lihat Write(String, Object[]) untuk deskripsi kemampuan pemformatan komposit yang ditawarkan.

Write(ReadOnlySpan<Char>)

Sumber:

StreamWriter.cs

Menulis rentang karakter ke aliran.

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

Parameter

buffer

ReadOnlySpan<Char>

Rentang karakter untuk menulis.

Write(String)

Sumber:

StreamWriter.cs

Menulis string ke aliran.

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)

Parameter

value

String

String yang akan ditulis ke aliran. Jika value null, tidak ada yang ditulis.

Pengecualian

ObjectDisposedException

AutoFlush benar atau buffer StreamWriter penuh, dan penulis saat ini ditutup.

NotSupportedException

AutoFlush benar atau buffer StreamWriter penuh, dan konten buffer tidak dapat ditulis ke aliran ukuran tetap yang mendasar karena StreamWriter berada di akhir aliran.

IOException

Terjadi kesalahan I/O.

Keterangan

Metode ini mengambil alih TextWriter.Write.

String yang ditentukan ditulis ke aliran yang mendasarinya kecuali akhir aliran tercapai sebelum waktunya.

Flush dipanggil secara otomatis jika AutoFlushtrue. Jika valuenull, tidak ada entri yang ditulis.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• I/O File dan Stream
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

Write(Char[])

Sumber:

StreamWriter.cs

Menulis array karakter ke aliran.

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

Parameter

buffer

Char[]

Array karakter yang berisi data untuk ditulis. Jika buffernull, tidak ada yang ditulis.

Pengecualian

IOException

Terjadi kesalahan I/O.

ObjectDisposedException

AutoFlush benar atau buffer StreamWriter penuh, dan penulis saat ini ditutup.

NotSupportedException

AutoFlush benar atau buffer StreamWriter penuh, dan konten buffer tidak dapat ditulis ke aliran ukuran tetap yang mendasar karena StreamWriter berada di akhir aliran.

Keterangan

Metode ini mengambil alih TextWriter.Write.

Karakter yang ditentukan ditulis ke aliran yang mendasarinya kecuali akhir aliran tercapai sebelum waktunya. Jika AutoFlushtrue, Flush dipanggil secara otomatis.

Metode ini mungkin memberikan performa yang lebih cepat daripada Write (char[],``int,``int) karena memiliki lebih sedikit argumen untuk diperiksa.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• I/O File dan Stream
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

Write(Char)

Sumber:

StreamWriter.cs

Menulis karakter ke aliran.

public:
 override void Write(char value);

public override void Write (char value);

override this.Write : char -> unit

Public Overrides Sub Write (value As Char)

Parameter

value

Char

Karakter yang akan ditulis ke aliran.

Pengecualian

IOException

Terjadi kesalahan I/O.

ObjectDisposedException

AutoFlush benar atau buffer StreamWriter penuh, dan penulis saat ini ditutup.

NotSupportedException

AutoFlush benar atau buffer StreamWriter penuh, dan konten buffer tidak dapat ditulis ke aliran ukuran tetap yang mendasar karena StreamWriter berada di akhir aliran.

Keterangan

Metode ini mengambil alih TextWriter.Write.

Karakter yang ditentukan ditulis ke aliran yang mendasarinya kecuali akhir aliran tercapai sebelum waktunya. Jika AutoFlushtrue, Flush dipanggil secara otomatis.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• I/O File dan Stream
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

Write(String, Object)

Sumber:

StreamWriter.cs

Menulis string yang diformat ke aliran, menggunakan semantik yang sama dengan metode 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)

Parameter

format

String

String format komposit.

arg0

Object

Objek untuk memformat dan menulis.

Keterangan

Lihat Write(String, Object) untuk deskripsi kemampuan pemformatan komposit yang ditawarkan.