TextWriter.Write Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menulis data ke aliran teks.
Overload
Write(String, Object, Object, Object) |
Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan metode Format(String, Object, Object, Object). |
Write(Char[], Int32, Int32) |
Menulis subarray karakter ke aliran teks. |
Write(String, ReadOnlySpan<Object>) |
Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan Format(String, ReadOnlySpan<Object>). |
Write(String, Object[]) |
Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan metode Format(String, Object[]). |
Write(String, Object) |
Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan metode Format(String, Object). |
Write(UInt64) |
Menulis representasi teks dari bilangan bulat yang tidak ditandatangani 8-byte ke aliran teks. |
Write(UInt32) |
Menulis representasi teks dari bilangan bulat yang tidak ditandatangani 4-byte ke aliran teks. |
Write(StringBuilder) |
Menulis pembangun string ke aliran teks. |
Write(String) |
Menulis string ke aliran teks. |
Write(Single) |
Menulis representasi teks dari nilai floating-point 4-byte ke aliran teks. |
Write(String, Object, Object) |
Menulis string yang diformat ke aliran teks menggunakan semantik yang sama dengan metode Format(String, Object, Object). |
Write(Object) |
Menulis representasi teks objek ke aliran teks dengan memanggil metode |
Write(Int64) |
Menulis representasi teks dari bilangan bulat bertanda tangan 8-byte ke aliran teks. |
Write(Int32) |
Menulis representasi teks dari bilangan bulat bertanda tangan 4-byte ke aliran teks. |
Write(Double) |
Menulis representasi teks dari nilai floating-point 8-byte ke aliran teks. |
Write(Decimal) |
Menulis representasi teks dari nilai desimal ke aliran teks. |
Write(Char[]) |
Menulis array karakter ke aliran teks. |
Write(Char) |
Menulis karakter ke aliran teks. |
Write(Boolean) |
Menulis representasi teks dari nilai |
Write(ReadOnlySpan<Char>) |
Menulis rentang karakter ke aliran teks. |
Write(String, Object, Object, Object)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan metode Format(String, Object, Object, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public virtual void Write (string format, object arg0, object arg1, object arg2);
public virtual void Write (string format, object? arg0, object? arg1, object? arg2);
abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit
Public Overridable 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.
Pengecualian
format
null
.
TextWriter ditutup.
Terjadi kesalahan I/O.
format
bukan string format komposit yang valid.
-atau-
Indeks item format kurang dari 0 (nol), atau lebih besar dari atau sama dengan jumlah objek yang akan diformat (yang, untuk metode ini kelebihan beban, adalah tiga).
Keterangan
Metode ini menggunakan pemformatan komposit untuk mengonversi nilai objek ke representasi stringnya dan untuk menyematkan representasi tersebut dalam string. .NET menyediakan dukungan pemformatan ekstensif, yang dijelaskan secara lebih rinci dalam topik pemformatan berikut:
Untuk informasi selengkapnya tentang fitur pemformatan komposit, lihat Pemformatan Komposit.
Untuk informasi selengkapnya tentang penentu format numerik, lihat String Format Numerik Standar dan String Format Numerik Kustom.
Untuk informasi selengkapnya tentang penentu format tanggal dan waktu, lihat String Format Tanggal dan Waktu Standar dan String Format Tanggal dan Waktu Kustom.
Untuk informasi selengkapnya tentang penentu format enumerasi, lihat String Format Enumerasi.
Untuk informasi selengkapnya tentang pemformatan, lihat Tipe Pemformatan.
Parameter format
terdiri dari nol atau lebih eksekusi teks yang diindeks dengan nol atau lebih tempat penampung terindeks, yang disebut item format, yang sesuai dengan objek dalam daftar parameter metode ini. Proses pemformatan menggantikan setiap item format dengan representasi string dari nilai objek yang sesuai.
Sintaks item format adalah sebagai berikut:
{indeks [, panjang][:formatString]}
Elemen dalam tanda kurung siku bersifat opsional. Tabel berikut ini menjelaskan setiap elemen. Untuk informasi selengkapnya tentang fitur pemformatan komposit, termasuk sintaks item format, lihat Pemformatan Komposit.
Elemen | Deskripsi |
---|---|
Indeks | Posisi berbasis nol dalam daftar parameter objek yang akan diformat. Jika objek yang ditentukan oleh indeks |
, panjang |
Jumlah minimum karakter dalam representasi string parameter. Jika positif, parameter selaras dengan kanan; jika negatif, diratakan kiri. |
: formatString |
String format standar atau kustom yang didukung oleh objek yang akan diformat. Nilai yang mungkin untuk formatString sama dengan nilai yang didukung oleh metode ToString(string format) objek. Jika formatString tidak ditentukan dan objek yang akan diformat mengimplementasikan antarmuka IFormattable, null diteruskan sebagai nilai parameter format yang digunakan sebagai string format IFormattable.ToString. |
Karakter kurung kurawal di depan dan berikutnya, "{" dan "}", diperlukan. Untuk menentukan satu karakter kurung kurawal literal di format
, tentukan dua karakter kurung kurawal di depan atau di belakang; yaitu, "{{" atau "}}".
Metode ini tidak mencari string yang ditentukan untuk karakter baris baru individual (0x000a heksadesimal) dan menggantinya dengan TextWriter.NewLine.
Jika objek tertentu tidak dirujuk dalam string format, objek tersebut diabaikan.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(Char[], Int32, Int32)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis subarray karakter ke aliran teks.
public:
virtual void Write(cli::array <char> ^ buffer, int index, int count);
public virtual void Write (char[] buffer, int index, int count);
abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit
Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)
Parameter
- buffer
- Char[]
Array karakter untuk menulis data.
- index
- Int32
Posisi karakter dalam buffer untuk mulai mengambil data.
- count
- Int32
Jumlah karakter yang akan ditulis.
Pengecualian
Panjang buffer dikurangi index
kurang dari count
.
Parameter buffer
null
.
index
atau count
negatif.
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Metode ini akan menulis count
karakter data ke dalam TextWriter
ini dari array karakter buffer
mulai dari posisi index
.
Kelebihan beban ini setara dengan kelebihan beban Write(Char[]) untuk setiap karakter dalam buffer
antara index
dan (index
+ count
).
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- Write(Char[], Int32, Int32)
- Write(Char[], Int32, Int32)
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(String, ReadOnlySpan<Object>)
Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan Format(String, ReadOnlySpan<Object>).
public:
virtual void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public virtual void Write (string format, scoped ReadOnlySpan<object?> arg);
abstract member Write : string * ReadOnlySpan<obj> -> unit
override this.Write : string * ReadOnlySpan<obj> -> unit
Public Overridable Sub Write (format As String, arg As ReadOnlySpan(Of Object))
Parameter
- format
- String
String format komposit.
- arg
- ReadOnlySpan<Object>
Rentang objek yang berisi nol atau lebih objek untuk diformat dan ditulis.
Berlaku untuk
Write(String, Object[])
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan metode Format(String, Object[]).
public:
virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void Write (string format, params object[] arg);
public virtual void Write (string format, params object?[] arg);
abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit
Public Overridable 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.
Pengecualian
format
atau arg
null
.
TextWriter ditutup.
Terjadi kesalahan I/O.
format
bukan string format komposit yang valid.
-atau-
Indeks item format kurang dari 0 (nol), atau lebih besar dari atau sama dengan panjang array arg
.
Keterangan
Metode ini menggunakan pemformatan komposit untuk mengonversi nilai objek ke representasi stringnya dan untuk menyematkan representasi tersebut dalam string. .NET menyediakan dukungan pemformatan ekstensif, yang dijelaskan secara lebih rinci dalam topik pemformatan berikut:
Untuk informasi selengkapnya tentang fitur pemformatan komposit, lihat Pemformatan Komposit.
Untuk informasi selengkapnya tentang penentu format numerik, lihat String Format Numerik Standar dan String Format Numerik Kustom.
Untuk informasi selengkapnya tentang penentu format tanggal dan waktu, lihat String Format Tanggal dan Waktu Standar dan String Format Tanggal dan Waktu Kustom.
Untuk informasi selengkapnya tentang penentu format enumerasi, lihat String Format Enumerasi.
Untuk informasi selengkapnya tentang pemformatan, lihat Tipe Pemformatan.
Parameter format
terdiri dari nol atau lebih eksekusi teks yang diindeks dengan nol atau lebih tempat penampung terindeks, yang disebut item format, yang sesuai dengan objek dalam daftar parameter metode ini. Proses pemformatan menggantikan setiap item format dengan representasi string dari nilai objek yang sesuai.
Sintaks item format adalah sebagai berikut:
{indeks [, panjang][:formatString]}
Elemen dalam tanda kurung siku bersifat opsional. Tabel berikut ini menjelaskan setiap elemen. Untuk informasi selengkapnya tentang fitur pemformatan komposit, termasuk sintaks item format, lihat Pemformatan Komposit.
Elemen | Deskripsi |
---|---|
Indeks | Posisi berbasis nol dalam daftar parameter objek yang akan diformat. Jika objek yang ditentukan oleh indeks |
, panjang |
Jumlah minimum karakter dalam representasi string parameter. Jika positif, parameter selaras dengan kanan; jika negatif, diratakan kiri. |
: formatString |
String format standar atau kustom yang didukung oleh objek yang akan diformat. Nilai yang mungkin untuk formatString sama dengan nilai yang didukung oleh metode ToString(string format) objek. Jika formatString tidak ditentukan dan objek yang akan diformat mengimplementasikan antarmuka IFormattable, null diteruskan sebagai nilai parameter format yang digunakan sebagai string format IFormattable.ToString. |
Karakter kurung kurawal di depan dan berikutnya, "{" dan "}", diperlukan. Untuk menentukan satu karakter kurung kurawal literal di format
, tentukan dua karakter kurung kurawal di depan atau di belakang; yaitu, "{{" atau "}}".
Metode ini tidak mencari string yang ditentukan untuk karakter baris baru individual (0x000a heksadesimal) dan menggantinya dengan TextWriter.NewLine.
Jika objek tertentu tidak dirujuk dalam string format, objek tersebut diabaikan.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(String, Object)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan metode Format(String, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0);
public virtual void Write (string format, object arg0);
public virtual void Write (string format, object? arg0);
abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit
Public Overridable Sub Write (format As String, arg0 As Object)
Parameter
- format
- String
String format komposit.
- arg0
- Object
Objek untuk memformat dan menulis.
Pengecualian
format
null
.
TextWriter ditutup.
Terjadi kesalahan I/O.
format
bukan string format komposit yang valid.
-atau-
Indeks item format kurang dari 0 (nol), atau lebih besar dari atau sama dengan jumlah objek yang akan diformat (yang, untuk metode ini kelebihan beban, adalah satu).
Keterangan
Metode ini menggunakan pemformatan komposit untuk mengonversi nilai objek ke representasi stringnya dan untuk menyematkan representasi tersebut dalam string. .NET menyediakan dukungan pemformatan ekstensif, yang dijelaskan secara lebih rinci dalam topik pemformatan berikut:
Untuk informasi selengkapnya tentang fitur pemformatan komposit, lihat Pemformatan Komposit.
Untuk informasi selengkapnya tentang penentu format numerik, lihat String Format Numerik Standar dan String Format Numerik Kustom.
Untuk informasi selengkapnya tentang penentu format tanggal dan waktu, lihat String Format Tanggal dan Waktu Standar dan String Format Tanggal dan Waktu Kustom.
Untuk informasi selengkapnya tentang penentu format enumerasi, lihat String Format Enumerasi.
Untuk informasi selengkapnya tentang pemformatan, lihat Tipe Pemformatan.
Parameter format
terdiri dari nol atau lebih eksekusi teks yang diindeks dengan nol atau lebih tempat penampung terindeks, yang disebut item format, yang sesuai dengan objek dalam daftar parameter metode ini. Proses pemformatan menggantikan setiap item format dengan representasi string dari nilai objek yang sesuai.
Sintaks item format adalah sebagai berikut:
{indeks [, panjang][:formatString]}
Elemen dalam tanda kurung siku bersifat opsional. Tabel berikut ini menjelaskan setiap elemen. Untuk informasi selengkapnya tentang fitur pemformatan komposit, termasuk sintaks item format, lihat Pemformatan Komposit.
Elemen | Deskripsi |
---|---|
Indeks | Posisi berbasis nol dalam daftar parameter objek yang akan diformat. Jika objek yang ditentukan oleh indeks |
, panjang |
Jumlah minimum karakter dalam representasi string parameter. Jika positif, parameter selaras dengan kanan; jika negatif, diratakan kiri. |
: formatString |
String format standar atau kustom yang didukung oleh objek yang akan diformat. Nilai yang mungkin untuk formatString sama dengan nilai yang didukung oleh metode ToString(string format) objek. Jika formatString tidak ditentukan dan objek yang akan diformat mengimplementasikan antarmuka IFormattable, null diteruskan sebagai nilai parameter format yang digunakan sebagai string format IFormattable.ToString. |
Karakter kurung kurawal di depan dan berikutnya, "{" dan "}", diperlukan. Untuk menentukan satu karakter kurung kurawal literal di format
, tentukan dua karakter kurung kurawal di depan atau di belakang; yaitu, "{{" atau "}}".
Metode ini tidak mencari string yang ditentukan untuk karakter baris baru individual (0x000a heksadesimal) dan menggantinya dengan TextWriter.NewLine.
Jika objek tertentu tidak dirujuk dalam string format, objek tersebut diabaikan.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(UInt64)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Penting
API ini bukan kompatibel CLS.
Menulis representasi teks dari bilangan bulat yang tidak ditandatangani 8-byte ke aliran teks.
public:
virtual void Write(System::UInt64 value);
[System.CLSCompliant(false)]
public virtual void Write (ulong value);
[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit
Public Overridable Sub Write (value As ULong)
Parameter
- value
- UInt64
Bilangan bulat yang tidak ditandatangani 8-byte untuk ditulis.
- Atribut
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil metode UInt64.ToString. Properti TextWriter.FormatProvider, jika tidak null
, menentukan pemformatan khusus budaya.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(UInt32)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Penting
API ini bukan kompatibel CLS.
Menulis representasi teks dari bilangan bulat yang tidak ditandatangani 4-byte ke aliran teks.
public:
virtual void Write(System::UInt32 value);
[System.CLSCompliant(false)]
public virtual void Write (uint value);
[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit
Public Overridable Sub Write (value As UInteger)
Parameter
- value
- UInt32
Bilangan bulat yang tidak ditandatangani 4-byte untuk ditulis.
- Atribut
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil metode UInt32.ToString. Properti TextWriter.FormatProvider, jika tidak null
, menentukan pemformatan khusus budaya.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(StringBuilder)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis pembangun string ke aliran teks.
public:
virtual void Write(System::Text::StringBuilder ^ value);
public virtual void Write (System.Text.StringBuilder? value);
abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit
Public Overridable Sub Write (value As StringBuilder)
Parameter
- value
- StringBuilder
String, sebagai penyusun string, untuk menulis ke aliran teks.
Keterangan
Metode ini setara dengan Write(stringBuilder.ToString())
, tetapi menggunakan metode StringBuilder.GetChunks untuk menghindari pembuatan string perantara.
Berlaku untuk
Write(String)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis string ke aliran teks.
public:
virtual void Write(System::String ^ value);
public virtual void Write (string value);
public virtual void Write (string? value);
abstract member Write : string -> unit
override this.Write : string -> unit
Public Overridable Sub Write (value As String)
Parameter
- value
- String
String yang akan ditulis.
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Kelebihan beban ini setara dengan kelebihan beban Write(Char[]).
Metode ini tidak mencari string yang ditentukan untuk karakter baris baru individual (0x000a heksadesimal) dan menggantinya dengan TextWriter.NewLine.
Jika value
null
, tidak ada yang ditulis ke aliran teks.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- Write(String)
- Write(String)
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(Single)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis representasi teks dari nilai floating-point 4-byte ke aliran teks.
public:
virtual void Write(float value);
public virtual void Write (float value);
abstract member Write : single -> unit
override this.Write : single -> unit
Public Overridable Sub Write (value As Single)
Parameter
- value
- Single
Nilai floating-point 4-byte untuk ditulis.
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil metode Single.ToString. Properti TextWriter.FormatProvider, jika tidak null
, menentukan pemformatan khusus budaya.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(String, Object, Object)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis string yang diformat ke aliran teks menggunakan semantik yang sama dengan metode Format(String, Object, Object).
public:
virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void Write (string format, object arg0, object arg1);
public virtual void Write (string format, object? arg0, object? arg1);
abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit
Public Overridable 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.
Pengecualian
format
null
.
TextWriter ditutup.
Terjadi kesalahan I/O.
format
bukan string format komposit yang valid.
-atau-
Indeks item format kurang dari 0 (nol) atau lebih besar dari atau sama dengan jumlah objek yang akan diformat (yang, untuk metode ini kelebihan beban, adalah dua).
Keterangan
Metode ini menggunakan pemformatan komposit untuk mengonversi nilai objek ke representasi stringnya dan untuk menyematkan representasi tersebut dalam string. .NET menyediakan dukungan pemformatan ekstensif, yang dijelaskan secara lebih rinci dalam topik pemformatan berikut:
Untuk informasi selengkapnya tentang fitur pemformatan komposit, lihat Pemformatan Komposit.
Untuk informasi selengkapnya tentang penentu format numerik, lihat String Format Numerik Standar dan String Format Numerik Kustom.
Untuk informasi selengkapnya tentang penentu format tanggal dan waktu, lihat String Format Tanggal dan Waktu Standar dan String Format Tanggal dan Waktu Kustom.
Untuk informasi selengkapnya tentang penentu format enumerasi, lihat String Format Enumerasi.
Untuk informasi selengkapnya tentang pemformatan, lihat Tipe Pemformatan.
Parameter format
terdiri dari nol atau lebih eksekusi teks yang diindeks dengan nol atau lebih tempat penampung terindeks, yang disebut item format, yang sesuai dengan objek dalam daftar parameter metode ini. Proses pemformatan menggantikan setiap item format dengan representasi string dari nilai objek yang sesuai.
Sintaks item format adalah sebagai berikut:
{indeks [, panjang][:formatString]}
Elemen dalam tanda kurung siku bersifat opsional. Tabel berikut ini menjelaskan setiap elemen. Untuk informasi selengkapnya tentang fitur pemformatan komposit, termasuk sintaks item format, lihat Pemformatan Komposit.
Elemen | Deskripsi |
---|---|
Indeks | Posisi berbasis nol dalam daftar parameter objek yang akan diformat. Jika objek yang ditentukan oleh indeks |
, panjang |
Jumlah minimum karakter dalam representasi string parameter. Jika positif, parameter selaras dengan kanan; jika negatif, diratakan kiri. |
: formatString |
String format standar atau kustom yang didukung oleh objek yang akan diformat. Nilai yang mungkin untuk formatString sama dengan nilai yang didukung oleh metode ToString(string format) objek. Jika formatString tidak ditentukan dan objek yang akan diformat mengimplementasikan antarmuka IFormattable, null diteruskan sebagai nilai parameter format yang digunakan sebagai string format IFormattable.ToString. |
Karakter kurung kurawal di depan dan berikutnya, "{" dan "}", diperlukan. Untuk menentukan satu karakter kurung kurawal literal di format
, tentukan dua karakter kurung kurawal di depan atau di belakang; yaitu, "{{" atau "}}".
Metode ini tidak mencari string yang ditentukan untuk karakter baris baru individual (0x000a heksadesimal) dan menggantinya dengan TextWriter.NewLine.
Jika objek tertentu tidak dirujuk dalam string format, objek tersebut diabaikan.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(Object)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis representasi teks objek ke aliran teks dengan memanggil metode ToString
pada objek tersebut.
public:
virtual void Write(System::Object ^ value);
public virtual void Write (object value);
public virtual void Write (object? value);
abstract member Write : obj -> unit
override this.Write : obj -> unit
Public Overridable Sub Write (value As Object)
Parameter
- value
- Object
Objek yang akan ditulis.
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Kelebihan beban ini setara dengan kelebihan beban Write(String).
Jika objek yang ditentukan null
, tidak ada tindakan yang diambil dan tidak ada pengecualian yang dilemparkan. Jika tidak, metode ToString
objek dipanggil untuk menghasilkan representasi string, dan string yang dihasilkan kemudian ditulis ke aliran output. Properti FormatProvider, jika tidak null
, menentukan pemformatan khusus budaya.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(Int64)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis representasi teks dari bilangan bulat bertanda tangan 8-byte ke aliran teks.
public:
virtual void Write(long value);
public virtual void Write (long value);
abstract member Write : int64 -> unit
override this.Write : int64 -> unit
Public Overridable Sub Write (value As Long)
Parameter
- value
- Int64
Bilangan bulat bertanda tangan 8-byte untuk ditulis.
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil metode Int64.ToString. Properti TextWriter.FormatProvider, jika tidak null
, menentukan pemformatan khusus budaya.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
Berlaku untuk
Write(Int32)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis representasi teks dari bilangan bulat bertanda tangan 4-byte ke aliran teks.
public:
virtual void Write(int value);
public virtual void Write (int value);
abstract member Write : int -> unit
override this.Write : int -> unit
Public Overridable Sub Write (value As Integer)
Parameter
- value
- Int32
Bilangan bulat bertanda tangan 4-byte untuk ditulis.
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil metode Int32.ToString. Properti TextWriter.FormatProvider, jika tidak null
, menentukan pemformatan khusus budaya.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(Double)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis representasi teks dari nilai floating-point 8-byte ke aliran teks.
public:
virtual void Write(double value);
public virtual void Write (double value);
abstract member Write : double -> unit
override this.Write : double -> unit
Public Overridable Sub Write (value As Double)
Parameter
- value
- Double
Nilai floating-point 8-byte untuk ditulis.
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil metode Double.ToString. Properti TextWriter.FormatProvider, jika tidak null
, menentukan pemformatan khusus budaya.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(Decimal)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis representasi teks dari nilai desimal ke aliran teks.
public:
virtual void Write(System::Decimal value);
public virtual void Write (decimal value);
abstract member Write : decimal -> unit
override this.Write : decimal -> unit
Public Overridable Sub Write (value As Decimal)
Parameter
- value
- Decimal
Nilai desimal untuk ditulis.
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Properti FormatProvider, jika tidak null
, menentukan pemformatan khusus budaya.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(Char[])
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis array karakter ke aliran teks.
public:
virtual void Write(cli::array <char> ^ buffer);
public virtual void Write (char[] buffer);
public virtual void Write (char[]? buffer);
abstract member Write : char[] -> unit
override this.Write : char[] -> unit
Public Overridable Sub Write (buffer As Char())
Parameter
- buffer
- Char[]
Array karakter untuk menulis ke aliran teks.
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Metode ini tidak mencari string yang ditentukan untuk karakter baris baru individual (0x000a heksadesimal) dan menggantinya dengan NewLine.
Metode default ini memanggil metode Write(Char[], Int32, Int32) dan meneruskan seluruh array karakter. Jika array karakter null
, tidak ada yang ditulis.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- Write(Char[])
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(Char)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis karakter ke aliran teks.
public:
abstract void Write(char value);
public:
virtual void Write(char value);
public abstract void Write (char value);
public virtual void Write (char value);
abstract member Write : char -> unit
abstract member Write : char -> unit
override this.Write : char -> unit
Public MustOverride Sub Write (value As Char)
Public Overridable Sub Write (value As Char)
Parameter
- value
- Char
Karakter untuk menulis ke aliran teks.
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Metode default ini tidak melakukan apa pun, tetapi kelas turunan dapat mengambil alih metode untuk menyediakan fungsionalitas yang sesuai.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- Write(Char)
- Write(Char)
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(Boolean)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis representasi teks dari nilai Boolean
ke aliran teks.
public:
virtual void Write(bool value);
public virtual void Write (bool value);
abstract member Write : bool -> unit
override this.Write : bool -> unit
Public Overridable Sub Write (value As Boolean)
Parameter
- value
- Boolean
Nilai Boolean
untuk ditulis.
Pengecualian
TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil metode Boolean.ToString.
Metode ini menghasilkan Boolean.TrueString atau Boolean.FalseString.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- I/O File dan Stream
- Cara: Membaca Teks dari File
- Cara: Menulis Teks ke File
Berlaku untuk
Write(ReadOnlySpan<Char>)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis rentang karakter ke aliran teks.
public:
virtual void Write(ReadOnlySpan<char> buffer);
public virtual void Write (ReadOnlySpan<char> buffer);
abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit
Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))
Parameter
- buffer
- ReadOnlySpan<Char>
Rentang karakter untuk menulis.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil ReadOnlySpan<Char>. Metode ToString.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.