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

Write(String, Object, Object, Object)

Sumber:

StreamWriter.cs

Menulis string yang diformat ke aliran, menggunakan semantik yang sama dengan Format(String, Object, Object, Object) metode .

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 memformat dan menulis.

arg1

Object

Objek kedua untuk memformat dan menulis.

arg2

Object

Objek ketiga untuk memformat dan menulis.

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 Format(String, Object, Object) metode .

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 memformat dan menulis.

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 untuk ditulis.

index

Int32

Posisi karakter dalam buffer untuk mulai membaca data.

count

Int32

Jumlah maksimum karakter yang akan ditulis.

Pengecualian

ArgumentNullException

bufferadalah null.

ArgumentException

Panjang buffer minus index kurang dari count.

ArgumentOutOfRangeException

index atau count negatif.

IOException

Terjadi kesalahan I/O.

ObjectDisposedException

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

NotSupportedException

AutoFlush benar atau StreamWriter buffer 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 TextWriter.Writealih .

Karakter dibaca dari buffer awal dan index dilanjutkan melalui index + (count - 1). Semua karakter ditulis ke aliran yang mendasarinya kecuali akhir aliran yang mendasarinya tercapai sebelum waktunya. Flush dipanggil secara otomatis jika AutoFlush adalah true.

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

Lihat juga

• I/O File dan Aliran
• 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 Format(String, Object[]) metode .

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(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 buffer adalah null, tidak ada yang ditulis.

Pengecualian

IOException

Terjadi kesalahan I/O.

ObjectDisposedException

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

NotSupportedException

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

Keterangan

Metode ini mengambil TextWriter.Writealih .

Karakter yang ditentukan ditulis ke aliran yang mendasarinya kecuali akhir aliran tercapai sebelum waktunya. Jika AutoFlush adalah true, 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 Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

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 StreamWriter buffer penuh, dan penulis saat ini ditutup.

NotSupportedException

AutoFlush benar atau StreamWriter buffer 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 TextWriter.Writealih .

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

Flush dipanggil secara otomatis jika AutoFlush adalah true. Jika value adalah null, tidak ada entri yang ditulis.

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

Lihat juga

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

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(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 untuk menulis ke aliran.

Pengecualian

IOException

Terjadi kesalahan I/O.

ObjectDisposedException

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

NotSupportedException

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

Keterangan

Metode ini mengambil TextWriter.Writealih .

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

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

Lihat juga

• I/O File dan Aliran
• 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 Format(String, Object) metode .

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.