ResXResourceSet Kelas

Definisi

Ruang nama:

System.Resources

Rakitan:

System.Windows.Forms.dll

Mewakili semua sumber daya dalam file sumber daya XML (.resx).

public ref class ResXResourceSet : System::Resources::ResourceSet

public class ResXResourceSet : System.Resources.ResourceSet

type ResXResourceSet = class
    inherit ResourceSet

Public Class ResXResourceSet
Inherits ResourceSet

Warisan

Object

ResourceSet

ResXResourceSet

Contoh

Contoh berikut membuat instans ResXResourceSet objek dan menggambarkan cara menghitung sumber dayanya dan mengambil sumber daya individual berdasarkan nama. Untuk setiap sumber daya yang dijumlahkannya, contohnya menggunakan IDictionaryEnumerator.Key properti dalam panggilan ke GetString metode atau GetObject , tergantung pada apakah nilai sumber daya adalah string atau objek.

using System;
using System.Collections;
using System.Drawing;
using System.Resources;

public class Example
{
   public static void Main()
   {
      CreateResXFile();
      
      ResXResourceSet resSet = new ResXResourceSet(@".\StoreResources.resx");
      IDictionaryEnumerator dict = resSet.GetEnumerator();
      while (dict.MoveNext()) {
         string key = (string) dict.Key;
         // Retrieve resource by name.
         if (dict.Value is string)
            Console.WriteLine("{0}: {1}", key, resSet.GetString(key));
         else
            Console.WriteLine("{0}: {1}", key, resSet.GetObject(key));   
      }
   }

   private static void CreateResXFile()
   {
      Bitmap logo = new Bitmap(@".\Logo.bmp");
      ResXDataNode node;
      
      ResXResourceWriter rw = new ResXResourceWriter(@".\StoreResources.resx");
      node = new ResXDataNode("Logo", logo);
      node.Comment = "The corporate logo.";
      rw.AddResource(node); 
      rw.AddResource("AppTitle", "Store Locations");
      node = new ResXDataNode("nColumns", 5);
      node.Comment = "The number of columns in the Store Location table";
      rw.AddResource(node);
      rw.AddResource("City", "City");
      rw.AddResource("State", "State");
      rw.AddResource("Code", "Zip Code");
      rw.AddResource("Telephone", "Phone");
      rw.Generate();
      rw.Close();
   }
}
// The example displays the following output:
//       Telephone: Phone
//       Code: Zip Code
//       State: State
//       City: City
//       nColumns: 5
//       AppTitle: Store Locations
//       Logo: System.Drawing.Bitmap

Imports System.Collections
Imports System.Drawing
Imports System.Resources

Module Example
   Public Sub Main()
      CreateResXFile()
      
      Dim resSet As New ResXResourceSet(".\StoreResources.resx")
      Dim dict As IDictionaryEnumerator = resSet.GetEnumerator()
      Do While dict.MoveNext()
         Dim key As String = CStr(dict.Key)
         ' Retrieve resource by name.
         If typeof dict.Value Is String Then
            Console.WriteLine("{0}: {1}", key, resSet.GetString(key))
         Else
            Console.WriteLine("{0}: {1}", key, resSet.GetObject(key))   
         End If
      Loop
   End Sub
   
   Private Sub CreateResXFile()
      Dim logo As New Bitmap(".\Logo.bmp")
      Dim node As ResXDataNode
      
      Dim rw As New ResXResourceWriter(".\StoreResources.resx")
      node = New ResXDataNode("Logo", logo)
      node.Comment = "The corporate logo."
      rw.AddResource(node) 
      rw.AddResource("AppTitle", "Store Locations")
      node = New ResXDataNode("nColumns", 5)
      node.Comment = "The number of columns in the Store Location table"
      rw.AddResource(node)
      rw.AddResource("City", "City")
      rw.AddResource("State", "State")
      rw.AddResource("Code", "Zip Code")
      rw.AddResource("Telephone", "Phone")
      rw.Generate()
      rw.Close()
   End Sub
End Module
' The example displays the following output:
'       Telephone: Phone
'       Code: Zip Code
'       State: State
'       City: City
'       nColumns: 5
'       AppTitle: Store Locations
'       Logo: System.Drawing.Bitmap

Contoh memanggil CreateResXFile metode untuk membuat file sumber daya XML yang diperlukan. Ini memerlukan file bitmap bernama Logo.bmp di direktori tempat contoh berjalan.

Keterangan

Penting

Metode panggilan dari kelas ini dengan data yang tidak tepercaya adalah risiko keamanan. Panggil metode dari kelas ini hanya dengan data tepercaya. Untuk informasi selengkapnya, lihat Memvalidasi Semua Input.

Kelas ResXResourceSet menghitung lebih dari IResourceReader, memuat setiap nama dan nilai, dan menyimpannya dalam tabel hash. Anda kemudian dapat menghitung sumber daya dalam ResXResourceSet objek atau mengambil sumber daya individual berdasarkan nama.

Objek ResXResourceSet menyediakan cara mudah untuk membaca semua sumber daya dalam file .resx ke dalam memori. Anda dapat menggunakan GetObject metode untuk mengambil sumber daya tertentu ketika file .resx telah dibaca ke dalam ResXResourceSet instans.

Catatan Bagi Inheritor

Kelas turunan yang ResXResourceSet menggunakan pembaca dan penulis sumber daya mereka sendiri harus mengambil alih GetDefaultReader() metode dan GetDefaultWriter() untuk menyediakan fungsionalitas yang sesuai untuk menafsirkan ResXResourceSet instans.

Konstruktor

ResXResourceSet(Stream)	Menginisialisasi instans ResXResourceSet baru kelas menggunakan default ResXResourceReader sistem untuk membaca sumber daya dari aliran yang ditentukan.
ResXResourceSet(String)	Menginisialisasi instans ResXResourceSet baru kelas menggunakan default ResXResourceReader sistem yang membuka dan membaca sumber daya dari file yang ditentukan.

Bidang

Reader	Menunjukkan yang IResourceReader digunakan untuk membaca sumber daya. (Diperoleh dari ResourceSet)
Table	tempat Hashtable sumber daya disimpan. (Diperoleh dari ResourceSet)

Metode

Close()	Menutup dan merilis sumber daya apa pun yang digunakan oleh ini ResourceSet. (Diperoleh dari ResourceSet)
Dispose()	Membuang sumber daya (selain memori) yang digunakan oleh instans saat ini dari ResourceSet. (Diperoleh dari ResourceSet)
Dispose(Boolean)	Merilis sumber daya (selain memori) yang terkait dengan instans saat ini, menutup objek terkelola internal jika diminta. (Diperoleh dari ResourceSet)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetDefaultReader()	Mengembalikan kelas pembaca sumber daya pilihan untuk jenis ResXResourceSetini.
GetDefaultWriter()	Mengembalikan kelas penulis sumber daya pilihan untuk jenis ResXResourceSetini.
GetEnumerator()	Mengembalikan yang IDictionaryEnumerator dapat melakukan iterasi melalui ResourceSet. (Diperoleh dari ResourceSet)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetObject(String)	Mencari objek sumber daya dengan nama yang ditentukan. (Diperoleh dari ResourceSet)
GetObject(String, Boolean)	Mencari objek sumber daya dengan nama yang ditentukan dengan cara yang tidak peka huruf besar/kecil, jika diminta. (Diperoleh dari ResourceSet)
GetString(String)	String Mencari sumber daya dengan nama yang ditentukan. (Diperoleh dari ResourceSet)
GetString(String, Boolean)	Mencari String sumber daya dengan nama yang ditentukan dengan cara yang tidak peka huruf besar/kecil, jika diminta. (Diperoleh dari ResourceSet)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ReadResources()	Membaca semua sumber daya dan menyimpannya dalam yang Hashtable ditunjukkan di Table properti . (Diperoleh dari ResourceSet)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Metode Ekstensi

Lihat juga

• Bekerja dengan File .resx Secara Terprogram