ResourceWriter 類別

定義

將系統預設格式中的資源寫入輸出檔或輸出資料流。 此類別無法獲得繼承。

public ref class ResourceWriter sealed : IDisposable, System::Resources::IResourceWriter
public ref class ResourceWriter sealed : IDisposable
public ref class ResourceWriter sealed : System::Resources::IResourceWriter
public sealed class ResourceWriter : IDisposable, System.Resources.IResourceWriter
public sealed class ResourceWriter : IDisposable
public sealed class ResourceWriter : System.Resources.IResourceWriter
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ResourceWriter : System.Resources.IResourceWriter
type ResourceWriter = class
    interface IDisposable
    interface IResourceWriter
type ResourceWriter = class
    interface IDisposable
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable
[<System.Runtime.InteropServices.ComVisible(true)>]
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable
Public NotInheritable Class ResourceWriter
Implements IDisposable, IResourceWriter
Public NotInheritable Class ResourceWriter
Implements IDisposable
Public NotInheritable Class ResourceWriter
Implements IResourceWriter
繼承
ResourceWriter
屬性
實作

範例

下列範例會將數個字串寫入 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 。 使用於查閱時,資源名稱會區分大小寫,但為了更輕鬆地支援 authoring tool 並協助消除 bug, ResourceWriter 將不會允許 .resources 檔擁有只有大小寫不同的名稱。 ResourceWriter類別可讓您建立字串、物件和二進位資源。 您可以將二進位資源以位元組陣列或資料流程的形式寫入資源檔中。

重要

此型別代表 IDisposable 介面。 當您完成使用型別時,您應該直接或間接處置它。 若要直接處置型別,請呼叫其 try/catch 區塊中的 Dispose 方法。 若要間接處置它,請使用語言建構函式,例如 using (在 C# 中) 或 Using (在 Visual Basic 中)。 如需詳細資訊,請參閱 IDisposable 介面文章中的<使用實作 IDisposable 的物件>一節。

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

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

若要從類別建立的二進位 .resources 檔中取出資源 ResourceWriter ,您可以使用 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)

適用於

另請參閱