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 关闭文件。 如果未显式调用 Generate，则调用 Close 将隐式调用 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, 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)

另请参阅

• IResourceWriter
• IDisposable
• 在桌面应用中 资源
• 为桌面应用创建资源文件