ResourceWriter Kelas

Definisi

Ruang nama:

System.Resources

Rakitan:

netstandard.dll, 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 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.

Important

Jenis ini mengimplementasikan antarmuka IDisposable. Setelah selesai menggunakan jenis , Anda harus membuangnya baik secara langsung (dengan memanggil metodenya Dispose ) atau secara tidak langsung (dengan konstruksi bahasa seperti using di C#). Untuk informasi selengkapnya, lihat Menggunakan objek yang mengimplementasikan IDisposable.

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 akan selalu 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

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

Properti

Nama	Deskripsi
TypeNameConverter	Mendapatkan atau mengatur delegasi yang memungkinkan rakitan sumber daya ditulis versi target .NET Framework sebelum .NET Framework 4 dengan menggunakan nama rakitan yang memenuhi syarat.

Metode

Nama	Deskripsi
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, 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, Stream)	Menambahkan sumber daya bernama yang ditentukan sebagai aliran ke daftar sumber daya yang akan ditulis.
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 Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (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