ResourceWriter 类

定义

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

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 方法将资源指定为名称和值对。 资源名称在用于查找时区分大小写,但为了更轻松地支持创作工具并帮助消除 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)

适用于

另请参阅