ResXResourceWriter Kelas

Referensi

Definisi

Ruang nama:: System.Resources

Rakitan:: System.Windows.Forms.dll

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: Object
ResXResourceWriter

Penerapan: IDisposable IResourceWriter

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)

Berlaku untuk

Lihat juga

Bekerja dengan File .resx Secara Terprogram