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 介面文章中的＜使用實作 IDisposable 的物件＞一節。

若要建立資源檔，請使用唯一的檔名建立 ResourceWriter 、至少呼叫 AddResource 一次、呼叫 Generate 以將資源檔寫入磁碟，然後呼叫 Close 以關閉檔案。 如果您未明確呼叫 ，則呼叫 Close 會隱含 Generate 呼叫 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)	加入具名資源，這個資源已指定為要寫入資源清單的資料流。
AddResource(String, Stream, Boolean)	加入已指定為要寫入資源清單之資料流的具名資源，並指定該資料流是否應於 Generate() 方法呼叫之後關閉。
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
• 傳統型應用程式中的資源
• 建立桌面應用程式的資源檔