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 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 使你能够创建字符串、对象和二进制资源。 可将二进制资源作为字节数组或流写入资源文件。
Important
此类型实现 IDisposable 接口。 使用完类型后,应直接(通过调用其 Dispose 方法)或间接(使用 C# 等 using 语言构造)将其释放。 有关详细信息,请参阅 使用实现 IDisposable 的对象。
若要创建资源文件,请创建 ResourceWriter 一个具有唯一文件名的文件名,至少调用 AddResource 一次,调用 Generate 将资源文件写入磁盘,然后调用 Close 以关闭该文件。 如果未显式调用,则调用Close将隐式调用GenerateGenerate。
资源不一定按添加的顺序编写。
若要从类创建的 ResourceWriter 二进制 .resources 文件中检索资源,可以使用 ResourceManager 该类(该类可用于检索命名资源)或 ResourceReader 类,该类可用于枚举文件中的所有资源。
构造函数
| 名称 | 说明 |
|---|---|
| ResourceWriter(Stream) |
初始化类的新实例,该实例 ResourceWriter 将资源写入提供的流。 |
| ResourceWriter(String) |
初始化将资源写入指定文件类的新实例 ResourceWriter 。 |
属性
| 名称 | 说明 |
|---|---|
| TypeNameConverter |
获取或设置一个委托,该委托允许使用限定的程序集名称在 .NET Framework 4 之前编写.NET框架的目标版本。 |
方法
| 名称 | 说明 |
|---|---|
| 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) |