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 Format(String, Object, Object, Object) metode . |
Write(Char[], Int32, Int32) |
Menulis subarray karakter ke aliran teks. |
Write(String, Object[]) |
Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan Format(String, Object[]) metode . |
Write(String, Object) |
Menulis string yang diformat ke aliran teks, menggunakan semantik yang sama dengan Format(String, Object) metode . |
Write(UInt64) |
Menulis representasi teks dari bilangan bulat 8-byte yang tidak ditandatangani 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 Format(String, Object, Object) metode . |
Write(Object) |
Menulis representasi teks objek ke aliran teks dengan memanggil metode pada objek tersebut |
Write(Int64) |
Menulis representasi teks bilangan bulat bertanda tangan 8-byte ke aliran teks. |
Write(Int32) |
Menulis representasi teks bilangan bulat bertanda 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 |
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 Format(String, Object, Object, Object) metode .
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 untuk memformat dan menulis.
Pengecualian
format
adalah null
.
Sudah 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:
{index[,length][: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 adalah null , item format digantikan oleh String.Empty. Karena kelebihan beban ini memiliki tiga objek dalam daftar parameternya, nilai indeks harus selalu 0, 1, atau 2. Jika tidak ada parameter dalam posisi indeks , akan FormatException dilemparkan. |
,length | Jumlah minimum karakter dalam representasi string parameter. Jika positif, parameter diratakan 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 objek ToString(string format) . Jika formatString tidak ditentukan dan objek yang akan diformat mengimplementasikan IFormattable antarmuka, null diteruskan sebagai nilai format parameter yang digunakan sebagai IFormattable.ToString string format. |
Karakter kurung kurawal di depan dan di belakang, "{" dan "}", diperlukan. Untuk menentukan karakter kurung kurawal literal tunggal 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 yang ditentukan tidak dirujuk dalam string format, objek tersebut akan diabaikan.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Aliran
- 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
.
Parameternya buffer
adalah null
.
index
atau count
negatif.
Sudah TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Metode ini akan menulis count
karakter data ke dalam ini TextWriter
dari array karakter mulai buffer
dari posisi index
.
Kelebihan beban ini setara Write(Char[]) dengan kelebihan beban untuk setiap karakter di 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 Aliran
- 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 Format(String, Object[]) metode .
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
adalah null
.
Sudah 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 arg
array.
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 serta String Format Tanggal dan Waktu Kustom.
Untuk informasi selengkapnya tentang penentu format enumerasi, lihat String Format Enumerasi.
Untuk informasi selengkapnya tentang pemformatan, lihat Jenis 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 terkait.
Sintaks item format adalah sebagai berikut:
{index[,length][: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 adalah null , item format digantikan oleh String.Empty. Karena kelebihan beban ini memiliki array dalam daftar parameternya, nilai indeks harus selalu kurang dari panjang array. Jika tidak ada parameter dalam posisi indeks , akan FormatException dilemparkan. |
,length | Jumlah minimum karakter dalam representasi string parameter. Jika positif, parameter diratakan dengan kanan; jika negatif, sejajar 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 objek ToString(string format) . Jika formatString tidak ditentukan dan objek yang akan diformat mengimplementasikan IFormattable antarmuka, null diteruskan sebagai nilai format parameter yang digunakan sebagai IFormattable.ToString string format. |
Karakter kurung kurawal di awal dan akhir, "{" dan "}", diperlukan. Untuk menentukan karakter kurung kurawal literal tunggal di format
, tentukan dua karakter kurung kurawal di awal atau akhir; yaitu, "{{" atau "}}".
Metode ini tidak mencari string yang ditentukan untuk karakter baris baru individual (0x000a heksadesimal) dan menggantinya dengan TextWriter.NewLine.
Jika objek yang ditentukan tidak dirujuk dalam string format, objek tersebut akan diabaikan.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Aliran
- 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 Format(String, Object) metode .
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
adalah null
.
Sudah 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 serta String Format Tanggal dan Waktu Kustom.
Untuk informasi selengkapnya tentang penentu format enumerasi, lihat String Format Enumerasi.
Untuk informasi selengkapnya tentang pemformatan, lihat Jenis 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 terkait.
Sintaks item format adalah sebagai berikut:
{index[,length][: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 adalah null , item format digantikan oleh String.Empty. Karena kelebihan beban ini hanya memiliki satu objek dalam daftar parameternya, nilai indeks harus selalu 0. Jika tidak ada parameter dalam posisi indeks , akan FormatException dilemparkan. |
,length | Jumlah minimum karakter dalam representasi string parameter. Jika positif, parameter diratakan dengan kanan; jika negatif, sejajar 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 objek ToString(string format) . Jika formatString tidak ditentukan dan objek yang akan diformat mengimplementasikan IFormattable antarmuka, null diteruskan sebagai nilai format parameter yang digunakan sebagai IFormattable.ToString string format. |
Karakter kurung kurawal di awal dan akhir, "{" dan "}", diperlukan. Untuk menentukan karakter kurung kurawal literal tunggal di format
, tentukan dua karakter kurung kurawal di awal atau akhir; yaitu, "{{" atau "}}".
Metode ini tidak mencari string yang ditentukan untuk karakter baris baru individual (0x000a heksadesimal) dan menggantinya dengan TextWriter.NewLine.
Jika objek yang ditentukan tidak dirujuk dalam string format, objek tersebut akan diabaikan.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Aliran
- 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 8-byte yang tidak ditandatangani untuk ditulis.
- Atribut
Pengecualian
Sudah TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil UInt64.ToString metode . 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 Aliran
- 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 4-byte yang tidak ditandatangani untuk ditulis.
- Atribut
Pengecualian
Sudah TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil UInt32.ToString metode . 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 Aliran
- 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 StringBuilder.GetChunks metode 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
Sudah TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Kelebihan beban ini setara Write(Char[]) dengan kelebihan beban.
Metode ini tidak mencari string yang ditentukan untuk karakter baris baru individual (0x000a heksadesimal) dan menggantinya dengan TextWriter.NewLine.
Jika value
adalah 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 Aliran
- 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
Sudah TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil Single.ToString metode . 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 Aliran
- 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 Format(String, Object, Object) metode .
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 memformat dan menulis.
- arg1
- Object
Objek kedua untuk memformat dan menulis.
Pengecualian
format
adalah null
.
Sudah 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 serta String Format Tanggal dan Waktu Kustom.
Untuk informasi selengkapnya tentang penentu format enumerasi, lihat String Format Enumerasi.
Untuk informasi selengkapnya tentang pemformatan, lihat Jenis 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 terkait.
Sintaks item format adalah sebagai berikut:
{index[,length][: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 adalah null , item format digantikan oleh String.Empty. Karena kelebihan beban ini memiliki dua objek dalam daftar parameternya, nilai indeks harus selalu 0 atau 1. Jika tidak ada parameter dalam posisi indeks , akan FormatException dilemparkan. |
,length | Jumlah minimum karakter dalam representasi string parameter. Jika positif, parameter diratakan dengan kanan; jika negatif, sejajar 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 objek ToString(string format) . Jika formatString tidak ditentukan dan objek yang akan diformat mengimplementasikan IFormattable antarmuka, null diteruskan sebagai nilai format parameter yang digunakan sebagai IFormattable.ToString string format. |
Karakter kurung kurawal di awal dan akhir, "{" dan "}", diperlukan. Untuk menentukan karakter kurung kurawal literal tunggal di format
, tentukan dua karakter kurung kurawal di awal atau akhir; yaitu, "{{" atau "}}".
Metode ini tidak mencari string yang ditentukan untuk karakter baris baru individual (0x000a heksadesimal) dan menggantinya dengan TextWriter.NewLine.
Jika objek yang ditentukan tidak dirujuk dalam string format, objek tersebut akan diabaikan.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- IFormatProvider
- I/O File dan Aliran
- 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 pada objek tersebut ToString
.
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
Sudah TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Kelebihan beban ini setara Write(String) dengan kelebihan beban.
Jika objek yang ditentukan adalah null
, tidak ada tindakan yang diambil dan tidak ada pengecualian yang dilemparkan. Jika tidak, metode objek ToString
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 Aliran
- 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 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
Sudah TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil Int64.ToString metode . 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 bilangan bulat bertanda 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
Sudah TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil Int32.ToString metode . 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 Aliran
- 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
Sudah TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil Double.ToString metode . 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 Aliran
- 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 yang akan ditulis.
Pengecualian
Sudah 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 Aliran
- 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
Sudah 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 Write(Char[], Int32, Int32) metode dan meneruskan seluruh array karakter. Jika array karakter adalah null
, tidak ada yang ditulis.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
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
Sudah 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
Berlaku untuk
Write(Boolean)
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
- Sumber:
- TextWriter.cs
Menulis representasi teks dari Boolean
nilai 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
yang akan ditulis.
Pengecualian
Sudah TextWriter ditutup.
Terjadi kesalahan I/O.
Keterangan
Representasi teks dari nilai yang ditentukan dihasilkan dengan memanggil Boolean.ToString metode .
Metode ini menghasilkan atau Boolean.TrueStringBoolean.FalseString.
Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.
Lihat juga
- StreamWriter
- StringWriter
- I/O File dan Aliran
- 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.
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk