ResourceWriter 类

定义

命名空间:

System.Resources

程序集:

System.Resources.Writer.dll

Source:

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
• 桌面应用中的资源
• 创建桌面应用程序的资源文件