ResXResourceWriter Kelas
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 sumber daya dalam file sumber daya XML (.resx) atau aliran output.
public ref class ResXResourceWriter : System::Resources::IResourceWriter
public ref class ResXResourceWriter : IDisposable, System::Resources::IResourceWriter
public class ResXResourceWriter : System.Resources.IResourceWriter
public class ResXResourceWriter : IDisposable, System.Resources.IResourceWriter
type ResXResourceWriter = class
interface IResourceWriter
interface IDisposable
Public Class ResXResourceWriter
Implements IResourceWriter
Public Class ResXResourceWriter
Implements IDisposable, IResourceWriter
- Warisan
-
ResXResourceWriter
- Penerapan
Contoh
Contoh berikut membuat file .resx bernama CarResources.resx
yang menyimpan enam string, ikon, dan dua objek yang ditentukan aplikasi (dua Automobile
objek). Perhatikan bahwa Automobile
kelas , yang didefinisikan dan diinstansiasi dalam contoh, ditandai dengan SerializableAttribute atribut .
using System;
using System.Drawing;
using System.Resources;
[Serializable()] public class Automobile
{
private string carMake;
private string carModel;
private int carYear;
private int carDoors;
private int carCylinders;
public Automobile(string make, string model, int year) :
this(make, model, year, 0, 0)
{ }
public Automobile(string make, string model, int year,
int doors, int cylinders)
{
this.carMake = make;
this.carModel = model;
this.carYear = year;
this.carDoors = doors;
this.carCylinders = cylinders;
}
public string Make {
get { return this.carMake; }
}
public string Model {
get {return this.carModel; }
}
public int Year {
get { return this.carYear; }
}
public int Doors {
get { return this.carDoors; }
}
public int Cylinders {
get { return this.carCylinders; }
}
}
public class Example
{
public static void Main()
{
// Instantiate an Automobile object.
Automobile car1 = new Automobile("Ford", "Model N", 1906, 0, 4);
Automobile car2 = new Automobile("Ford", "Model T", 1909, 2, 4);
// Define a resource file named CarResources.resx.
using (ResXResourceWriter resx = new ResXResourceWriter(@".\CarResources.resx"))
{
resx.AddResource("Title", "Classic American Cars");
resx.AddResource("HeaderString1", "Make");
resx.AddResource("HeaderString2", "Model");
resx.AddResource("HeaderString3", "Year");
resx.AddResource("HeaderString4", "Doors");
resx.AddResource("HeaderString5", "Cylinders");
resx.AddResource("Information", SystemIcons.Information);
resx.AddResource("EarlyAuto1", car1);
resx.AddResource("EarlyAuto2", car2);
}
}
}
Imports System.Drawing
Imports System.Resources
<Serializable()> Public Class Automobile
Private carMake As String
Private carModel As String
Private carYear As Integer
Private carDoors AS Integer
Private carCylinders As Integer
Public Sub New(make As String, model As String, year As Integer)
Me.New(make, model, year, 0, 0)
End Sub
Public Sub New(make As String, model As String, year As Integer,
doors As Integer, cylinders As Integer)
Me.carMake = make
Me.carModel = model
Me.carYear = year
Me.carDoors = doors
Me.carCylinders = cylinders
End Sub
Public ReadOnly Property Make As String
Get
Return Me.carMake
End Get
End Property
Public ReadOnly Property Model As String
Get
Return Me.carModel
End Get
End Property
Public ReadOnly Property Year As Integer
Get
Return Me.carYear
End Get
End Property
Public ReadOnly Property Doors As Integer
Get
Return Me.carDoors
End Get
End Property
Public ReadOnly Property Cylinders As Integer
Get
Return Me.carCylinders
End Get
End Property
End Class
Module Example
Public Sub Main()
' Instantiate an Automobile object.
Dim car1 As New Automobile("Ford", "Model N", 1906, 0, 4)
Dim car2 As New Automobile("Ford", "Model T", 1909, 2, 4)
' Define a resource file named CarResources.resx.
Using resx As New ResXResourceWriter(".\CarResources.resx")
resx.AddResource("Title", "Classic American Cars")
resx.AddResource("HeaderString1", "Make")
resx.AddResource("HeaderString2", "Model")
resx.AddResource("HeaderString3", "Year")
resx.AddResource("HeaderString4", "Doors")
resx.AddResource("HeaderString5", "Cylinders")
resx.AddResource("Information", SystemIcons.Information)
resx.AddResource("EarlyAuto1", car1)
resx.AddResource("EarlyAuto2", car2)
End Using
End Sub
End Module
Keterangan
Sumber ResXResourceWriter daya tulis dalam format XML. Untuk menulis file sumber daya biner, gunakan ResourceWriter.
Sumber daya ditentukan sebagai pasangan nama/nilai menggunakan AddResource metode . Nama sumber daya peka huruf besar/kecil saat digunakan untuk pencarian; tetapi untuk lebih mudah mendukung alat penulisan dan membantu menghilangkan bug, ResXResourceWriter tidak memungkinkan file a.resx untuk memiliki nama yang hanya bervariasi menurut kasus.
Untuk membuat file a.resx, buat ResXResourceWriter dengan nama file unik, panggil AddResource setidaknya sekali, panggil Generate untuk menulis file sumber daya ke disk, lalu panggil Close untuk menutup file. Memanggil Close akan secara Generate implisit file jika diperlukan.
Sumber daya tidak selalu ditulis dalam urutan yang sama dengan yang ditambahkan.
Untuk informasi selengkapnya tentang format file a.resx, lihat Bekerja dengan File .resx Secara Terprogram.
Catatan
Kelas ini berisi permintaan tautan dan permintaan warisan di tingkat kelas yang berlaku untuk semua anggota. SecurityException dilemparkan ketika pemanggil langsung atau kelas turunan tidak memiliki izin kepercayaan penuh.
Konstruktor
ResXResourceWriter(Stream) |
Menginisialisasi instans baru kelas ResXResourceWriter yang menulis sumber daya ke objek stream yang ditentukan. |
ResXResourceWriter(Stream, Func<Type,String>) |
Menginisialisasi instans ResXResourceWriter baru kelas yang menulis sumber daya ke objek stream tertentu dan mengatur delegasi konverter. Delegasi ini memungkinkan rakitan sumber daya ditulis bahwa versi target .NET Framework sebelum .NET Framework 4 dengan menggunakan nama rakitan yang memenuhi syarat. |
ResXResourceWriter(String) |
Menginisialisasi instans baru kelas ResXResourceWriter yang menulis sumber daya ke file yang ditentukan. |
ResXResourceWriter(String, Func<Type,String>) |
Menginisialisasi instans ResXResourceWriter baru kelas yang menulis sumber daya ke file tertentu dan menetapkan delegasi yang memungkinkan rakitan sumber daya ditulis bahwa versi target .NET Framework sebelum .NET Framework 4 dengan menggunakan nama rakitan yang memenuhi syarat. |
ResXResourceWriter(TextWriter) |
Menginisialisasi instans baru kelas ResXResourceWriter yang menulis ke objek yang ditentukan TextWriter . |
ResXResourceWriter(TextWriter, Func<Type,String>) |
Menginisialisasi instans ResXResourceWriter baru kelas yang menulis sumber daya ke objek tertentu TextWriter dan menetapkan delegasi yang memungkinkan rakitan sumber daya ditulis bahwa versi target .NET Framework sebelum .NET Framework 4 dengan menggunakan nama rakitan yang memenuhi syarat. |
Bidang
BinSerializedObjectMimeType |
Menentukan tipe isi default untuk objek biner. Bidang ini hanya-baca. |
ByteArraySerializedObjectMimeType |
Menentukan tipe konten default untuk objek array byte. Bidang ini hanya-baca. |
DefaultSerializedObjectMimeType |
Menentukan tipe isi default untuk suatu objek. Bidang ini hanya-baca. |
ResMimeType |
Menentukan tipe isi sumber daya XML. Bidang ini hanya-baca. |
ResourceSchema |
Menentukan skema yang akan digunakan dalam menulis file XML. Bidang ini hanya-baca. |
SoapSerializedObjectMimeType |
Menentukan tipe isi untuk objek SOAP. Bidang ini hanya-baca. |
Version |
Menentukan versi skema yang sesuai dengan output XML. Bidang ini hanya-baca. |
Properti
BasePath |
Mendapatkan atau mengatur jalur dasar untuk jalur file relatif yang ditentukan dalam ResXFileRef objek. |
Metode
AddAlias(String, AssemblyName) |
Menambahkan alias yang ditentukan ke daftar alias. |
AddMetadata(String, Byte[]) |
Menambahkan properti waktu desain yang nilainya ditentukan sebagai array byte ke daftar sumber daya untuk ditulis. |
AddMetadata(String, Object) |
Menambahkan properti waktu desain yang nilainya ditentukan sebagai objek ke daftar sumber daya untuk ditulis. |
AddMetadata(String, String) |
Menambahkan properti waktu desain yang nilainya ditentukan sebagai string ke daftar sumber daya untuk ditulis. |
AddResource(ResXDataNode) |
Menambahkan sumber daya bernama yang ditentukan dalam ResXDataNode objek ke daftar sumber daya untuk ditulis. |
AddResource(String, Byte[]) |
Menambahkan sumber daya bernama yang ditentukan sebagai array byte ke daftar sumber daya untuk ditulis. |
AddResource(String, Object) |
Menambahkan sumber daya bernama yang ditentukan sebagai objek ke daftar sumber daya untuk ditulis. |
AddResource(String, String) |
Menambahkan sumber daya string ke sumber daya. |
Close() |
Merilis semua sumber daya yang ResXResourceWriterdigunakan oleh . |
Dispose() |
Merilis semua sumber daya yang ResXResourceWriterdigunakan oleh . |
Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang digunakan oleh ResXResourceWriter dan secara opsional merilis sumber daya terkelola. |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
Finalize() |
Anggota ini mengambil Finalize() alih metode . |
Generate() |
Menulis semua sumber daya yang AddResource(String, Byte[]) ditambahkan oleh metode ke file atau aliran output. |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |