ResourceWriter クラス

定義

名前空間:

System.Resources

アセンブリ:

System.Resources.Writer.dll

ソース:

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 名前と値のペアとして指定されます。 リソース名は、検索に使用すると大文字と小文字が区別されますが、作成ツールをより簡単にサポートし、バグを排除するために、 ResourceWriter .resources ファイルでは大文字と小文字のみが異なる名前を付けられません。 ResourceWriterクラスを使用すると、文字列、オブジェクト、バイナリ リソースを作成できます。 バイナリ リソースは、バイト配列またはストリームとしてリソース ファイルに書き込むことができます。

重要

この型は IDisposable インターフェイスを実装します。 型の使用が完了したら、直接的または間接的に型を破棄する必要があります。 直接的に型を破棄するには、try/catch ブロック内で Dispose メソッドを呼び出します。 間接的に型を破棄するには、using (C# の場合) または Using (Visual Basic 言語) などの言語構成要素を使用します。 詳細については、IDisposable インターフェイスに関するトピック内の「IDisposable を実装するオブジェクトの使用」セクションを参照してください。

リソース ファイルを作成するには、一意のファイル名で をResourceWriter作成し、少なくとも 1 回を呼び出し、 を呼び出AddResourceGenerateしてリソース ファイルをディスクに書き込み、 を呼び出Closeしてファイルを閉じます。 を Close 明示的に呼び出さない場合、 を呼び Generate 出すと暗黙的に が呼び出 Generateされます。

リソースは、必ずしも追加されたのと同じ順序で書き込まれるとは限りません。

クラスによって作成されたバイナリ .resources ファイルからリソースを ResourceWriter 取得するには、 クラスを 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
• デスクトップ アプリケーションのリソース
• デスクトップ アプリケーションに対するリソース ファイルの作成