ResourceWriter

.NET Framework クラス ライブラリ リファレンス

ResourceWriter クラス

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

名前空間: System.Resources
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public NotInheritable Class
 ResourceWriter
    Implements IResourceWriter, IDisposable

Visual Basic (使用法)

Dim instance As ResourceWriter

C#

[ComVisibleAttribute(true)] 
public sealed class ResourceWriter : IResourceWriter,
 IDisposable

C++

[ComVisibleAttribute(true)] 
public ref class ResourceWriter sealed : IResourceWriter,
 IDisposable

J#

/** @attribute ComVisibleAttribute(true) */ 
public final class ResourceWriter implements
 IResourceWriter, IDisposable

JScript

ComVisibleAttribute(true) 
public final class ResourceWriter implements
 IResourceWriter, IDisposable

解説

ResourceWriter は、IResourceWriter インターフェイスの既定の実装を提供します。

リソースは、AddResource メソッドを使用して、名前と値のペアとして指定されます。検索に使用するときは、リソース名の大文字と小文字は区別されます。しかし、より簡単に編集ツールをサポートし、バグを減らすために、ResourceWriter では .resources ファイルに大文字と小文字の違いだけで区別される名前を含めることはできません。

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

リソースは、必ずしも追加された順序では書き込まれません。

使用例

myResources.resources ファイルにいくつかの文字列を書き込む例を次に示します。

Visual Basic

Imports System
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

C#

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();
   }
}

C++

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();
}

J#

import System.*;
import 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();
    } //main
} //WriteResources

継承階層

System.Object
  System.Resources.ResourceWriter

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ResourceWriter メンバ
System.Resources 名前空間
IResourceWriter インターフェイス
IDisposable
その他の技術情報
エンコーディングとローカリゼーション

ResourceWriter コンストラクタ (Stream)

指定したストリームにリソースを書き込む ResourceWriter クラスの新しいインスタンスを初期化します。

名前空間: System.Resources
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    stream As Stream _
)

Visual Basic (使用法)

Dim stream As Stream

Dim instance As New ResourceWriter(stream)

C#

public ResourceWriter (
    Stream stream
)

C++

public:
ResourceWriter (
    Stream^ stream
)

J#

public ResourceWriter (
    Stream stream
)

JScript

public function ResourceWriter (
    stream : Stream
)

パラメータ

stream

出力ストリーム。

例外

例外の種類	条件
ArgumentException	stream パラメータが書き込み可能ではありません。
ArgumentNullException	stream パラメータが null 参照 (Visual Basic では Nothing) です。

使用例

Visual Basic

Imports System
Imports System.Resources
Imports System.IO

Public Class WriteResources
   
    Public Shared Sub Main(args()
 As String)
        ' Create a file stream to encapsulate items.resources.
        Dim fs As New FileStream("items.resources",
 _
           FileMode.OpenOrCreate, FileAccess.Write)
      
        ' Open a resource writer to write from the stream.
        Dim writer = New ResourceWriter(fs)
      
        ' Add resources to the resource writer.
        writer.AddResource("String 1", "First
 String")
        writer.AddResource("String 2", "Second
 String")
        writer.AddResource("String 3", "Third
 String")
      
        ' Write the resources to the stream, and close it.
        writer.Close()
    End Sub

End Class

C#

using System;
using System.Resources;
using System.IO;

public class WriteResources 
{
    public static void Main(string[]
 args) 
    {  
        // Create a file stream to encapsulate items.resources.
        FileStream fs = new FileStream("items.resources",
 
        FileMode.OpenOrCreate,FileAccess.Write);

        // Open a resource writer to write from the stream.
        IResourceWriter writer = new ResourceWriter(fs);
    
        // Add resources to the resource writer.
        writer.AddResource("String 1", "First String");
        writer.AddResource("String 2", "Second String");
        writer.AddResource("String 3", "Third String");

        // Write the resources to the stream, and close it.
        writer.Close();
    }
}

C++

using namespace System;
using namespace System::Resources;
using namespace System::IO;
int main()
{
   
   // Create a file stream to encapsulate items.resources.
   FileStream^ fs = gcnew FileStream( "items.resources",FileMode::OpenOrCreate,FileAccess::Write
 );
   
   // Open a resource writer to write from the stream.
   IResourceWriter^ writer = gcnew ResourceWriter( fs );
   
   // Add resources to the resource writer.
   writer->AddResource( "String 1", "First String" );
   writer->AddResource( "String 2", "Second String" );
   writer->AddResource( "String 3", "Third String" );
   
   // Write the resources to the stream, and close it.
   writer->Close();
}

J#

import System.*;
import System.Resources.*;
import System.IO.*;

public class WriteResources
{

    public static void main(String[]
 args)
    {
        // Create a file stream to encapsulate items.resources.
        FileStream fs = new FileStream("items.resources",
 
            FileMode.OpenOrCreate, FileAccess.Write);

        // Open a resource writer to write from the stream.
        IResourceWriter writer = new ResourceWriter(fs);

        // Add resources to the resource writer.
        writer.AddResource("String 1", "First String");
        writer.AddResource("String 2", "Second String");
        writer.AddResource("String 3", "Third String");

        // Write the resources to the stream, and close it.
        writer.Close();
    } //main
} //WriteResources

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ResourceWriter クラス
ResourceWriter メンバ
System.Resources 名前空間
その他の技術情報
エンコーディングとローカリゼーション

ResourceWriter コンストラクタ (String)

指定したファイルにリソースを書き込む ResourceWriter クラスの新しいインスタンスを初期化します。

名前空間: System.Resources
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    fileName As String _
)

Visual Basic (使用法)

Dim fileName As String

Dim instance As New ResourceWriter(fileName)

C#

public ResourceWriter (
    string fileName
)

C++

public:
ResourceWriter (
    String^ fileName
)

J#

public ResourceWriter (
    String fileName
)

JScript

public function ResourceWriter (
    fileName : String
)

パラメータ

fileName

出力ファイル名。

例外

例外の種類	条件
ArgumentNullException	fileName パラメータが null 参照 (Visual Basic では Nothing) です。

使用例

Visual Basic

Imports System
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

C#

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();
   }
}

C++

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();
}

J#

import System.*;
import 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();
    } //main
} //WriteResources

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ResourceWriter クラス
ResourceWriter メンバ
System.Resources 名前空間
その他の技術情報
エンコーディングとローカリゼーション

ResourceWriter コンストラクタ

ResourceWriter クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
ResourceWriter (Stream)	指定したストリームにリソースを書き込む ResourceWriter クラスの新しいインスタンスを初期化します。
ResourceWriter (String)	指定したファイルにリソースを書き込む ResourceWriter クラスの新しいインスタンスを初期化します。

参照

関連項目

ResourceWriter クラス
ResourceWriter メンバ
System.Resources 名前空間

その他の技術情報

エンコーディングとローカリゼーション

ResourceWriter メソッド

パブリック メソッド

	名前	説明
	AddResource	オーバーロードされます。 リソースを書き込むリソースのリストに追加します。
	AddResourceData	書き込むリソースのリストに、データ ユニットをリソースとして追加します。
	Close	リソースを出力ストリームに保存してから閉じます。
	Dispose	リソース ファイルまたはストリームを閉じ、明示的にリソースを解放できます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	Generate	システムの既定の形式で、すべてのリソースを出力ストリームに保存します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

参照

関連項目

ResourceWriter クラス
System.Resources 名前空間
IResourceWriter インターフェイス
IDisposable

その他の技術情報

エンコーディングとローカリゼーション

ResourceWriter メンバ

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

ResourceWriter データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	ResourceWriter	オーバーロードされます。 ResourceWriter クラスの新しいインスタンスを初期化します。

パブリック メソッド

	名前	説明
	AddResource	オーバーロードされます。 リソースを書き込むリソースのリストに追加します。
	AddResourceData	書き込むリソースのリストに、データ ユニットをリソースとして追加します。
	Close	リソースを出力ストリームに保存してから閉じます。
	Dispose	リソース ファイルまたはストリームを閉じ、明示的にリソースを解放できます。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	Generate	システムの既定の形式で、すべてのリソースを出力ストリームに保存します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

参照

関連項目

ResourceWriter クラス
System.Resources 名前空間
IResourceWriter インターフェイス
IDisposable

その他の技術情報

エンコーディングとローカリゼーション