ResourceWriter 类

定义

命名空间:
System.Resources
程序集:
mscorlib.dll
程序集:
netstandard.dll

将系统默认格式的资源写入输出文件或输出流。 此类不能被继承。

public ref class ResourceWriter sealed : System::Resources::IResourceWriter
public sealed class ResourceWriter : System.Resources.IResourceWriter
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ResourceWriter : System.Resources.IResourceWriter
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable
[<System.Runtime.InteropServices.ComVisible(true)>]
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable
type ResourceWriter = class
    interface IDisposable
    interface IResourceWriter
Public NotInheritable Class ResourceWriter
Implements IResourceWriter
继承
Object
ResourceWriter
属性
ComVisibleAttribute
实现
IDisposable IResourceWriter

示例

以下示例将多个字符串写入 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 接口。 使用完该类型后，应直接或间接处理它。 若要直接释放类型，请在块中Disposetry/调用其catch方法。 若要间接释放它，请使用语言构造，例如 using （在 C# 中）或 Using （在 Visual Basic 中）。 有关详细信息，请参阅接口主题中的 IDisposable “使用实现 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)

适用于

另请参阅