ResourceWriter 類別

定義

命名空間:

System.Resources

組件:

System.Resources.Writer.dll

來源:

ResourceWriter.cs

以系統預設格式將資源寫入輸出檔案或輸出數據流。 無法繼承這個類別。

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

繼承

Object

ResourceWriter

實作

IDisposable IResourceWriter

範例

下列範例會將數個字串寫入 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

備註

ResourceWriter 提供 IResourceWriter 介面的默認實作。 它可讓您以程序設計方式建立二進位資源 （.resources） 檔案。

使用 AddResource 方法，將資源指定為名稱和值組。 資源名稱在用於查閱時會區分大小寫，但為了更輕鬆地支援撰寫工具並協助消除 Bug，ResourceWriter 不允許 .resources 檔案具有只依大小寫而有所不同的名稱。 ResourceWriter 類別可讓您建立字串、物件和二進位資源。 二進位資源可以寫入資源檔作為位元組數位或數據流。

重要

此類型會實作 IDisposable 介面。 當您完成使用類型時，應該直接或間接處置它。 若要直接處置類型，請在 try/catch 區塊中呼叫其 Dispose 方法。 若要間接處置它，請使用語言建構，例如 using （C#） 或 Using （在 Visual Basic 中）。 如需詳細資訊，請參閱 介面主題中的<使用實作 IDisposable 的物件>一節。

若要建立資源檔，請使用唯一的檔名建立 ResourceWriter、至少呼叫 AddResource 一次、呼叫 Generate 將資源檔寫入磁碟，然後呼叫 Close 以關閉檔案。 如果您未明確呼叫 Generate，則呼叫 Close 會隱含呼叫 Generate。

資源不一定是以新增資源的順序撰寫。

若要從 ResourceWriter 類別所建立的二進位 .resources 檔案擷取資源，您可以使用 ResourceManager 類別，讓您擷取具名資源，或 ResourceReader 類別，讓您列舉檔案中的所有資源。

建構函式

ResourceWriter(Stream)	初始化將資源寫入所提供數據流之 ResourceWriter 類別的新實例。
ResourceWriter(String)	初始化 ResourceWriter 類別的新實例，這個實例會將資源寫入指定的檔案。

屬性

TypeNameConverter

取得或設定委派，此委派可讓資源元件使用限定元件名稱，以 .NET Framework 4 之前的 .NET Framework 版本為目標寫入。

方法

AddResource(String, Byte[])	將指定為位元組陣列的具名資源新增至要寫入的資源清單。
AddResource(String, Object)	將指定為物件的具名資源新增至要寫入的資源清單。
AddResource(String, Stream, Boolean)	將指定為數據流的具名資源新增至要寫入的資源清單，並指定呼叫 Generate() 方法之後是否應該關閉數據流。
AddResource(String, Stream)	將指定為數據流的具名資源新增至要寫入的資源清單。
AddResource(String, String)	將字串資源新增至要寫入的資源清單。
AddResourceData(String, String, Byte[])	將數據單位當做資源加入要寫入的資源清單中。
Close()	將資源儲存至輸出數據流，然後關閉它。
Dispose()	允許使用者關閉資源檔或數據流，明確釋放資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Generate()	將所有資源儲存至系統預設格式的輸出數據流。
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	傳回表示目前 物件的字串。 (繼承來源 Object)

另請參閱

• IResourceWriter
• IDisposable
• Desktop Apps 中的資源
• 建立傳統型應用程式的資源檔