ResourceWriter 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將系統預設格式中的資源寫入輸出檔或輸出資料流。 此類別無法獲得繼承。
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) |