ResourceWriter クラス

定義

名前空間:

System.Resources

アセンブリ:

System.Resources.Writer.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

システムの既定の形式で、リソースを出力ファイルまたは出力ストリームに書き込みます。 このクラスは継承できません。

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

継承

Object

ResourceWriter

属性

ComVisibleAttribute

実装

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 回呼び出 AddResource し、リソース ファイルをディスクに書き込む呼び出 Generate し、ファイルを閉じる呼び出しを行 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
• デスクトップ アプリケーションのリソース
• デスクトップ アプリケーションに対するリソース ファイルの作成