ResourceWriter Kelas

Definisi

Ruang nama:

System.Resources

Rakitan:

System.Resources.Writer.dll

Sumber:

ResourceWriter.cs

Menulis sumber daya dalam format default sistem ke file output atau aliran output. Kelas ini tidak dapat diwariskan.

public ref class ResourceWriter sealed : IDisposable, System::Resources::IResourceWriter

public sealed class ResourceWriter : IDisposable, System.Resources.IResourceWriter

type ResourceWriter = class
    interface IDisposable
    interface IResourceWriter

Public NotInheritable Class ResourceWriter
Implements IDisposable, IResourceWriter

Warisan

Object

ResourceWriter

Penerapan

IDisposable IResourceWriter

Contoh

Contoh berikut menulis beberapa string ke dalam file myResources.resources.

using namespace System;
using namespace System::Resources;
int main()
{
   
   // Creates a resource writer.
   IResourceWriter^ writer = gcnew ResourceWriter( "myResources.resources" );
   
   // Adds resources to the resource writer.
   writer->AddResource( "String 1", "First String" );
   writer->AddResource( "String 2", "Second String" );
   writer->AddResource( "String 3", "Third String" );
   
   // Writes the resources to the file or stream, and closes it.
   writer->Close();
}

using System;
using System.Resources;

public class WriteResources {
   public static void Main(string[] args) {

      // Creates a resource writer.
      IResourceWriter writer = new ResourceWriter("myResources.resources");

      // Adds resources to the resource writer.
      writer.AddResource("String 1", "First String");

      writer.AddResource("String 2", "Second String");

      writer.AddResource("String 3", "Third String");

      // Writes the resources to the file or stream, and closes it.
      writer.Close();
   }
}

Imports System.Resources

Public Class WriteResources
    
    Public Shared Sub Main()
        
        ' Creates a resource writer.
        Dim writer As New ResourceWriter("myResources.resources")
        
        ' Adds resources to the resource writer.
        writer.AddResource("String 1", "First String")
        
        writer.AddResource("String 2", "Second String")
        
        writer.AddResource("String 3", "Third String")
        
        ' Writes the resources to the file or stream, and closes it.
        writer.Close()
    End Sub
End Class

Keterangan

ResourceWriter menyediakan implementasi IResourceWriter default antarmuka. Ini memungkinkan Anda membuat file sumber daya biner (.resources) secara terprogram.

Sumber daya ditentukan sebagai pasangan nama dan nilai menggunakan metode .AddResource Nama sumber daya peka huruf besar/kecil saat digunakan untuk pencarian, tetapi untuk lebih mudah mendukung alat penulisan dan membantu menghilangkan bug, ResourceWriter tidak akan memungkinkan file .resources memiliki nama yang hanya bervariasi menurut kasus. Kelas ini ResourceWriter memungkinkan Anda membuat string, objek, dan sumber daya biner. Sumber daya biner dapat ditulis ke file sumber daya sebagai array byte atau aliran.

Penting

Jenis ini mengimplementasikan IDisposable antarmuka. Ketika Anda telah selesai menggunakan jenis , Anda harus membuangnya baik secara langsung atau tidak langsung. Untuk membuang jenis secara langsung, panggil metodenya Dispose dalam try/catch blok. Untuk membuangnya secara tidak langsung, gunakan konstruksi bahasa seperti using (di C#) atau Using (di Visual Basic). Untuk informasi selengkapnya, lihat bagian "Menggunakan Objek yang Mengimplementasikan IDisposable" di IDisposable topik antarmuka.

Untuk membuat file sumber daya, buat ResourceWriter dengan nama file unik, panggil AddResource setidaknya sekali, panggil Generate untuk menulis file sumber daya ke disk, lalu panggil Close untuk menutup file. Panggilan Close akan secara implisit memanggil Generate jika Anda tidak secara eksplisit memanggil Generate.

Sumber daya tidak harus ditulis dalam urutan yang sama dengan yang ditambahkan.

Untuk mengambil sumber daya dari file .resources biner yang dibuat oleh ResourceWriter kelas , Anda dapat menggunakan ResourceManager kelas , yang memungkinkan Anda mengambil sumber daya bernama, atau ResourceReader kelas , yang memungkinkan Anda menghitung semua sumber daya dalam file.

Konstruktor

ResourceWriter(Stream)	Menginisialisasi instans baru kelas ResourceWriter yang menulis sumber daya ke aliran yang disediakan.
ResourceWriter(String)	Menginisialisasi instans baru kelas ResourceWriter yang menulis sumber daya ke file yang ditentukan.

Properti

TypeNameConverter

Mendapatkan atau menetapkan delegasi yang memungkinkan rakitan sumber daya ditulis yang menargetkan versi .NET Framework sebelum .NET Framework 4 dengan menggunakan nama rakitan yang memenuhi syarat.

Metode

AddResource(String, Byte[])	Menambahkan sumber daya bernama yang ditentukan sebagai array byte ke daftar sumber daya yang akan ditulis.
AddResource(String, Object)	Menambahkan sumber daya bernama yang ditentukan sebagai objek ke daftar sumber daya yang akan ditulis.
AddResource(String, Stream)	Menambahkan sumber daya bernama yang ditentukan sebagai aliran ke daftar sumber daya yang akan ditulis.
AddResource(String, Stream, Boolean)	Menambahkan sumber daya bernama yang ditentukan sebagai aliran ke daftar sumber daya yang akan ditulis, dan menentukan apakah aliran harus ditutup setelah Generate() metode dipanggil.
AddResource(String, String)	Menambahkan sumber daya string ke daftar sumber daya yang akan ditulis.
AddResourceData(String, String, Byte[])	Menambahkan unit data sebagai sumber daya ke daftar sumber daya yang akan ditulis.
Close()	Menyimpan sumber daya ke aliran output lalu menutupnya.
Dispose()	Memungkinkan pengguna untuk menutup file atau aliran sumber daya, secara eksplisit merilis sumber daya.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
Generate()	Menyimpan semua sumber daya ke aliran output dalam format default sistem.
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)

Lihat juga

• IResourceWriter
• IDisposable
• Sumber daya di Aplikasi Desktop
• Membuat File Sumber Daya untuk Aplikasi Desktop