ResourceWriter 類別

定義

命名空間:

System.Resources

組件:

netstandard.dll, 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 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 方法。 資源名稱在查詢時具有大小寫區分，但為了更方便支援創作工具並消除錯誤， ResourceWriter .resources 檔案的名稱只能依大小寫變化。 這個 ResourceWriter 類別讓你能建立字串、物件和二進位資源。 二進位資源可以寫入資源檔案，形式為位元組陣列或串流。

Important

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

要建立 resources 檔案，先建立 ResourceWriter 一個唯一檔名， AddResource 至少呼叫一次，呼叫 Generate 將資源檔案寫入磁碟，然後呼叫 Close 關閉該檔案。 若不明確呼叫，則Close默示呼叫Generate。Generate

資源不一定會按照加入順序寫入。

要從類別建立 ResourceWriter 的二進位 .resources 檔案中取得資源，你可以使用 類別（該 ResourceManager 類別）可以擷取命名資源，或 ResourceReader 使用 類別（類別）讓你枚舉檔案中所有資源。

建構函式

名稱	Description
ResourceWriter(Stream)	初始化一個新的類別實例 ResourceWriter ，將資源寫入所提供的串流。
ResourceWriter(String)	初始化一個新的類別實例 ResourceWriter ，將資源寫入指定檔案。

屬性

名稱	Description
TypeNameConverter	取得或設定一個代理，允許在 .NET Framework 4 之前，使用合格的組合名稱撰寫針對 .NET Framework 版本的資源組件。

方法

名稱	Description
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
• 桌面應用程式中的資源
• 為桌面應用程式建立資源檔案