ResXResourceWriter ResXResourceWriter ResXResourceWriter ResXResourceWriter Class

定義

XML リソース (.resx) ファイルまたは出力ストリームにリソースを書き込みます。Writes resources in an XML resource (.resx) file or an output stream.

public ref class ResXResourceWriter : System::Resources::IResourceWriter
public class ResXResourceWriter : System.Resources.IResourceWriter
type ResXResourceWriter = class
    interface IResourceWriter
    interface IDisposable
Public Class ResXResourceWriter
Implements IResourceWriter
継承
ResXResourceWriterResXResourceWriterResXResourceWriterResXResourceWriter
実装

次の例では、という名前の .resx ファイルを作成するCarResources.resx6 つの文字列、アイコン、および 2 つのアプリケーションで定義されたオブジェクトを格納する (2 つAutomobileオブジェクト)。The following example creates a .resx file named CarResources.resx that stores six strings, an icon, and two application-defined objects (two Automobile objects). 例で定義されてインスタンス化された Automobile クラスは、SerializableAttribute 属性でタグ付けされることに注意してください。Note that the Automobile class, which is defined and instantiated in the example, is tagged with the SerializableAttribute attribute.

using System;
using System.Drawing;
using System.Resources;

[Serializable()] public class Automobile
{
   private string carMake;
   private string carModel;
   private int carYear;
   private int carDoors;
   private int carCylinders;
   
   public Automobile(string make, string model, int year) :  
                     this(make, model, year, 0, 0)   
   { }
   
   public Automobile(string make, string model, int year, 
                     int doors, int cylinders)
   {                     
      this.carMake = make;
      this.carModel = model;
      this.carYear = year;
      this.carDoors = doors;
      this.carCylinders = cylinders;
   }

   public string Make {
      get { return this.carMake; }
   }       
   
   public string Model {
      get {return this.carModel; }
   }       
   
   public int Year {
      get { return this.carYear; }
   }       
   
   public int Doors {
      get { return this.carDoors; }
   }       
   
   public int Cylinders {
      get { return this.carCylinders; }
   }       
}

public class Example
{
   public static void Main()
   {
      // Instantiate an Automobile object.
      Automobile car1 = new Automobile("Ford", "Model N", 1906, 0, 4);
      Automobile car2 = new Automobile("Ford", "Model T", 1909, 2, 4);
      // Define a resource file named CarResources.resx.
      using (ResXResourceWriter resx = new ResXResourceWriter(@".\CarResources.resx"))
      {
         resx.AddResource("Title", "Classic American Cars");
         resx.AddResource("HeaderString1", "Make");
         resx.AddResource("HeaderString2", "Model");
         resx.AddResource("HeaderString3", "Year");
         resx.AddResource("HeaderString4", "Doors");
         resx.AddResource("HeaderString5", "Cylinders");
         resx.AddResource("Information", SystemIcons.Information); 
         resx.AddResource("EarlyAuto1", car1);  
         resx.AddResource("EarlyAuto2", car2);  
      }
   }
}
Imports System.Drawing
Imports System.Resources

<Serializable()> Public Class Automobile
   Private carMake As String
   Private carModel As String
   Private carYear As Integer
   Private carDoors AS Integer
   Private carCylinders As Integer
   
   Public Sub New(make As String, model As String, year As Integer) 
      Me.New(make, model, year, 0, 0)   
   End Sub
   
   Public Sub New(make As String, model As String, year As Integer, 
                  doors As Integer, cylinders As Integer)
      Me.carMake = make
      Me.carModel = model
      Me.carYear = year
      Me.carDoors = doors
      Me.carCylinders = cylinders
   End Sub

   Public ReadOnly Property Make As String
      Get
         Return Me.carMake
      End Get   
   End Property       
   
   Public ReadOnly Property Model As String
      Get
         Return Me.carModel
      End Get   
   End Property       
   
   Public ReadOnly Property Year As Integer
      Get
         Return Me.carYear
      End Get   
   End Property       
   
   Public ReadOnly Property Doors As Integer
      Get
         Return Me.carDoors
      End Get   
   End Property       
   
   Public ReadOnly Property Cylinders As Integer
      Get
         Return Me.carCylinders
      End Get   
   End Property       
End Class

Module Example
   Public Sub Main()
      ' Instantiate an Automobile object.
      Dim car1 As New Automobile("Ford", "Model N", 1906, 0, 4)
      Dim car2 As New Automobile("Ford", "Model T", 1909, 2, 4)
      ' Define a resource file named CarResources.resx.
      Using resx As New ResXResourceWriter(".\CarResources.resx")
         resx.AddResource("Title", "Classic American Cars")
         resx.AddResource("HeaderString1", "Make")
         resx.AddResource("HeaderString2", "Model")
         resx.AddResource("HeaderString3", "Year")
         resx.AddResource("HeaderString4", "Doors")
         resx.AddResource("HeaderString5", "Cylinders")
         resx.AddResource("Information", SystemIcons.Information) 
         resx.AddResource("EarlyAuto1", car1)
         resx.AddResource("EarlyAuto2", car2)  
      End Using
   End Sub
End Module

注釈

ResXResourceWriter XML 形式でリソースを書き込みます。The ResXResourceWriter writes resources in XML format. バイナリ リソース ファイルを書き込むには使用ResourceWriterします。To write a binary resource file, use ResourceWriter.

リソースを使用して、名前/値ペアとして指定、AddResourceメソッド。Resources are specified as name/value pairs using the AddResource method. リソース名は大文字の検索に使用する場合簡単に作成ツールをサポートし、バグを回避するが、 ResXResourceWriter a.resx ファイル ケースのみが異なる名前を付けることはできません。Resource names are case-sensitive when used for lookups; but to more easily support authoring tools and help eliminate bugs, ResXResourceWriter does not allow a.resx file to have names that vary only by case.

A.resx ファイルを作成するには、作成、 ResXResourceWriter 、一意のファイル名を使用して呼び出すAddResourceを少なくとも 1 回呼び出すGenerateをディスクにリソース ファイルを作成し、呼び出すCloseファイルを閉じます。To create a.resx file, create a ResXResourceWriter with a unique file name, call AddResource at least once, call Generate to write the resources file to disk, and then call Close to close the file. 呼び出すCloseを暗黙的にGenerateのために必要な場合は、ファイル。Calling Close will implicitly Generate the file if required.

リソースは、追加された順序と同じ順序で必ずしもは書き込まれません。The resources are not necessarily written in the same order they were added.

A.resx ファイルの形式の詳細については、次を参照してください。ファイル プログラムによる .resxします。For more information on the format of a.resx file, see Working with .resx Files Programmatically.

注意

このクラスには、リンク確認要求と、すべてのメンバーに適用されるクラス レベルの継承確認要求が含まれています。This class contains a link demand and an inheritance demand at the class level that applies to all members. 直接の呼び出し元か派生クラスのいずれかに完全信頼アクセス許可がない場合、SecurityException がスローされます。A SecurityException is thrown when either the immediate caller or the derived class does not have full-trust permission.

コンストラクター

ResXResourceWriter(Stream) ResXResourceWriter(Stream) ResXResourceWriter(Stream) ResXResourceWriter(Stream)

指定したストリーム オブジェクトにリソースを書き込む ResXResourceWriter クラスの新しいインスタンスを初期化します。Initializes a new instance of the ResXResourceWriter class that writes the resources to the specified stream object.

ResXResourceWriter(Stream, Func<Type,String>) ResXResourceWriter(Stream, Func<Type,String>) ResXResourceWriter(Stream, Func<Type,String>) ResXResourceWriter(Stream, Func<Type,String>)

指定したストリーム オブジェクトへのリソースの書き込みとコンバーター デリゲートの設定を行う ResXResourceWriter クラスの新しいインスタンスを初期化します。Initializes a new instance of the ResXResourceWriter class that writes the resources to a specified stream object and sets a converter delegate. このデリゲートは、修飾アセンブリ名を使用して .NET Framework 4.NET Framework 4 以前の各 .NET Framework バージョンを対象とするリソース アセンブリの書き込みを可能にします。This delegate enables resource assemblies to be written that target versions of the .NET Framework before the .NET Framework 4.NET Framework 4 by using qualified assembly names.

ResXResourceWriter(String) ResXResourceWriter(String) ResXResourceWriter(String) ResXResourceWriter(String)

指定したファイルにリソースを書き込む ResXResourceWriter クラスの新しいインスタンスを初期化します。Initializes a new instance of the ResXResourceWriter class that writes the resources to the specified file.

ResXResourceWriter(String, Func<Type,String>) ResXResourceWriter(String, Func<Type,String>) ResXResourceWriter(String, Func<Type,String>) ResXResourceWriter(String, Func<Type,String>)

ResXResourceWriter クラスの新しいインスタンスを初期化します。このクラスは、指定されたファイルにリソースを書き込み、修飾アセンブリ名を使用して .NET Framework 4.NET Framework 4 以前の各 .NET Framework バージョンを対象とするリソース アセンブリの書き込みを可能にするデリゲートを設定します。Initializes a new instance of the ResXResourceWriter class that writes the resources to a specified file and sets a delegate that enables resource assemblies to be written that target versions of the .NET Framework before the .NET Framework 4.NET Framework 4 by using qualified assembly names.

ResXResourceWriter(TextWriter) ResXResourceWriter(TextWriter) ResXResourceWriter(TextWriter) ResXResourceWriter(TextWriter)

指定した ResXResourceWriter オブジェクトにリソースを書き込む TextWriter クラスの新しいインスタンスを初期化します。Initializes a new instance of the ResXResourceWriter class that writes to the specified TextWriter object.

ResXResourceWriter(TextWriter, Func<Type,String>) ResXResourceWriter(TextWriter, Func<Type,String>) ResXResourceWriter(TextWriter, Func<Type,String>) ResXResourceWriter(TextWriter, Func<Type,String>)

ResXResourceWriter クラスの新しいインスタンスを初期化します。このクラスは、指定された TextWriter オブジェクトにリソースを書き込み、修飾アセンブリ名を使用して .NET Framework 4.NET Framework 4 以前の各 .NET Framework バージョンを対象とするリソース アセンブリの書き込みを可能にするデリゲートを設定します。Initializes a new instance of the ResXResourceWriter class that writes the resources to a specified TextWriter object and sets a delegate that enables resource assemblies to be written that target versions of the .NET Framework before the .NET Framework 4.NET Framework 4 by using qualified assembly names.

フィールド

BinSerializedObjectMimeType BinSerializedObjectMimeType BinSerializedObjectMimeType BinSerializedObjectMimeType

バイナリ オブジェクトの既定コンテンツ タイプを指定します。Specifies the default content type for a binary object. このフィールドは読み取り専用です。This field is read-only.

ByteArraySerializedObjectMimeType ByteArraySerializedObjectMimeType ByteArraySerializedObjectMimeType ByteArraySerializedObjectMimeType

バイト配列オブジェクトの既定コンテンツ タイプを指定します。Specifies the default content type for a byte array object. このフィールドは読み取り専用です。This field is read-only.

DefaultSerializedObjectMimeType DefaultSerializedObjectMimeType DefaultSerializedObjectMimeType DefaultSerializedObjectMimeType

オブジェクトの既定コンテンツ タイプを指定します。Specifies the default content type for an object. このフィールドは読み取り専用です。This field is read-only.

ResMimeType ResMimeType ResMimeType ResMimeType

XML リソースのコンテンツ タイプを指定します。Specifies the content type of an XML resource. このフィールドは読み取り専用です。This field is read-only.

ResourceSchema ResourceSchema ResourceSchema ResourceSchema

XML ファイルの書き込みに使用するスキーマを指定します。Specifies the schema to use in writing the XML file. このフィールドは読み取り専用です。This field is read-only.

SoapSerializedObjectMimeType SoapSerializedObjectMimeType SoapSerializedObjectMimeType SoapSerializedObjectMimeType

SOAP オブジェクトのコンテンツ タイプを指定します。Specifies the content type for a SOAP object. このフィールドは読み取り専用です。This field is read-only.

Version Version Version Version

XML 出力が準拠するスキーマのバージョンを指定します。Specifies the version of the schema that the XML output conforms to. このフィールドは読み取り専用です。This field is read-only.

プロパティ

BasePath BasePath BasePath BasePath

ResXFileRef オブジェクトで指定されている相対ファイル パスのベース パスを取得または設定します。Gets or sets the base path for the relative file path specified in a ResXFileRef object.

メソッド

AddAlias(String, AssemblyName) AddAlias(String, AssemblyName) AddAlias(String, AssemblyName) AddAlias(String, AssemblyName)

エイリアスのリストに、指定したエイリアスを追加します。Adds the specified alias to a list of aliases.

AddMetadata(String, Byte[]) AddMetadata(String, Byte[]) AddMetadata(String, Byte[]) AddMetadata(String, Byte[])

書き込むリソースのリストに、バイト配列として指定された値を持つデザイン時のプロパティを追加します。Adds a design-time property whose value is specified as a byte array to the list of resources to write.

AddMetadata(String, Object) AddMetadata(String, Object) AddMetadata(String, Object) AddMetadata(String, Object)

書き込むリソースのリストに、オブジェクトとして指定された値を持つデザイン時のプロパティを追加します。Adds a design-time property whose value is specified as an object to the list of resources to write.

AddMetadata(String, String) AddMetadata(String, String) AddMetadata(String, String) AddMetadata(String, String)

書き込むリソースのリストに、文字列として指定された値を持つデザイン時のプロパティを追加します。Adds a design-time property whose value is specified as a string to the list of resources to write.

AddResource(ResXDataNode) AddResource(ResXDataNode) AddResource(ResXDataNode) AddResource(ResXDataNode)

書き込むリソースのリストに、ResXDataNode オブジェクトで指定されている名前付きリソースを追加します。Adds a named resource specified in a ResXDataNode object to the list of resources to write.

AddResource(String, Byte[]) AddResource(String, Byte[]) AddResource(String, Byte[]) AddResource(String, Byte[])

書き込むリソースのリストに、バイト配列として指定された名前付きリソースを追加します。Adds a named resource specified as a byte array to the list of resources to write.

AddResource(String, Object) AddResource(String, Object) AddResource(String, Object) AddResource(String, Object)

書き込むリソースのリストに、オブジェクトとして指定された名前付きリソースを追加します。Adds a named resource specified as an object to the list of resources to write.

AddResource(String, String) AddResource(String, String) AddResource(String, String) AddResource(String, String)

文字列リソースをリソースに追加します。Adds a string resource to the resources.

Close() Close() Close() Close()

ResXResourceWriter によって使用されているすべてのリソースを解放します。Releases all resources used by the ResXResourceWriter.

Dispose() Dispose() Dispose() Dispose()

ResXResourceWriter によって使用されているすべてのリソースを解放します。Releases all resources used by the ResXResourceWriter.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

ResXResourceWriter によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the ResXResourceWriter and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

このメンバーは、Finalize() メソッドをオーバーライドします。This member overrides the Finalize() method.

Generate() Generate() Generate() Generate()

AddResource(String, Byte[]) メソッドで追加されたすべてのリソースを出力ファイルまたはストリームに書き込みます。Writes all resources added by the AddResource(String, Byte[]) method to the output file or stream.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

セキュリティ

LinkDemand
直前の呼び出し元に対する完全な信頼。for full trust for the immediate caller. このメンバーは、部分的に信頼されているコードから使用することはできません。This member cannot be used by partially trusted code.

InheritanceDemand
継承クラスの完全な信頼。for full trust for inheritors. 部分的に信頼されたコードでは、このメンバーを継承できません。This member cannot be inherited by partially trusted code.

適用対象

こちらもご覧ください