ResXResourceWriter Classe

Referência

Definição

Namespace:: System.Resources

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Grava os recursos em um arquivo de recurso XML (.resx) ou em um fluxo de saída.

public ref class ResXResourceWriter : System::Resources::IResourceWriter

public ref class ResXResourceWriter : IDisposable, System::Resources::IResourceWriter

public class ResXResourceWriter : System.Resources.IResourceWriter

public class ResXResourceWriter : IDisposable, System.Resources.IResourceWriter

type ResXResourceWriter = class
    interface IResourceWriter
    interface IDisposable

Public Class ResXResourceWriter
Implements IResourceWriter

Public Class ResXResourceWriter
Implements IDisposable, IResourceWriter

Herança: Object
ResXResourceWriter

Implementações: IDisposable IResourceWriter

Exemplos

O exemplo a seguir cria um arquivo .resx chamado CarResources.resx que armazena seis cadeias de caracteres, um ícone e dois objetos definidos pelo aplicativo (dois Automobile objetos). Observe que a classe Automobile, que é definida e instanciada no exemplo, é marcada com o atributo SerializableAttribute.

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

Comentários

O ResXResourceWriter grava recursos no formato XML. Para gravar um arquivo de recurso binário, use ResourceWriter.

Os recursos são especificados como pares nome/valor usando o AddResource método . Os nomes de recursos diferenciam maiúsculas de minúsculas quando usados para pesquisas; mas para dar suporte mais facilmente a ferramentas de criação e ajudar a eliminar bugs, ResXResourceWriter não permite que um arquivo a.resx tenha nomes que variam apenas por caso.

Para criar um arquivo a.resx, crie um ResXResourceWriter com um nome de arquivo exclusivo, chame AddResource pelo menos uma vez, chame Generate para gravar o arquivo de recursos no disco e chame Close para fechar o arquivo. Chamar Close chamará implicitamente Generate o arquivo, se necessário.

Os recursos não são necessariamente escritos na mesma ordem em que foram adicionados.

Para obter mais informações sobre o formato do arquivo a.resx, consulte Trabalhando com arquivos .resx programaticamente.

Observação

Esta classe contém uma demanda de link e uma demanda de herança no nível de classe que se aplica a todos os membros. Um SecurityException é lançado quando o chamador imediato ou a classe derivada não tem permissão de confiança total.

Construtores

ResXResourceWriter(Stream)	Inicializa uma nova instância da classe ResXResourceWriter que grava os recursos no objeto de fluxo especificado.
ResXResourceWriter(Stream, Func<Type,String>)	Inicializa uma nova instância da classe ResXResourceWriter que grava os recursos em um objeto de fluxo especificado e define um delegado do conversor. Este delegado permite a gravação de assemblies de recurso que direcionam versões do .NET Framework antes do .NET Framework 4 usando os nomes de assembly qualificados.
ResXResourceWriter(String)	Inicializa uma nova instância da classe ResXResourceWriter que grava os recursos no arquivo especificado.
ResXResourceWriter(String, Func<Type,String>)	Inicializa uma nova instância da classe ResXResourceWriter que grava os recursos em um arquivo especificado e define um delegado que permite a gravação de assemblies de recurso que direcionam versões do .NET Framework antes do .NET Framework 4 usando nomes de assembly qualificados.
ResXResourceWriter(TextWriter)	Inicializa uma nova instância da classe ResXResourceWriter que é gravada para o objeto TextWriter especificado.
ResXResourceWriter(TextWriter, Func<Type,String>)	Inicializa uma nova instância da classe ResXResourceWriter que grava os recursos em um objeto TextWriter especificado e define um delegado que permite a gravação de assemblies de recurso que direcionam versões do .NET Framework antes do .NET Framework 4 usando nomes de assembly qualificados.

Campos

BinSerializedObjectMimeType	Especifica o tipo de conteúdo padrão para um objeto binário. Este campo é somente leitura.
ByteArraySerializedObjectMimeType	Especifica o tipo de conteúdo padrão para um objeto de matriz de bytes. Este campo é somente leitura.
DefaultSerializedObjectMimeType	Especifica o tipo de conteúdo padrão para um objeto. Este campo é somente leitura.
ResMimeType	Especifica o tipo de conteúdo de um recurso XML. Este campo é somente leitura.
ResourceSchema	Especifica o esquema a ser usado para gravar o arquivo XML. Este campo é somente leitura.
SoapSerializedObjectMimeType	Especifica o tipo de conteúdo para um objeto SOAP. Este campo é somente leitura.
Version	Especifica a versão do esquema que é compatível com a saída XML. Este campo é somente leitura.

Propriedades

BasePath

Obtém ou define o caminho base para o caminho relativo do arquivo especificado em um objeto ResXFileRef.

Métodos

AddAlias(String, AssemblyName)	Adiciona o alias especificado a uma lista de aliases.
AddMetadata(String, Byte[])	Adiciona uma propriedade de tempo de design cujo valor é especificado como uma matriz de bytes à lista de recursos a serem gravados.
AddMetadata(String, Object)	Adiciona uma propriedade de tempo de design cujo valor é especificado como um objeto à lista de recursos a serem gravados.
AddMetadata(String, String)	Adiciona uma propriedade de tempo de design cujo valor é especificado como uma cadeia de caracteres à lista de recursos a serem gravados.
AddResource(ResXDataNode)	Adiciona um recurso nomeado especificado em um objeto ResXDataNode à lista de recursos a serem gravados.
AddResource(String, Byte[])	Adiciona um recurso nomeado especificado como uma matriz de bytes à lista de recursos a serem gravados.
AddResource(String, Object)	Adiciona um recurso nomeado especificado como um objeto à lista de recursos a serem gravados.
AddResource(String, String)	Adiciona um recurso de cadeia de caracteres aos recursos.
Close()	Libera todos os recursos usados pelo ResXResourceWriter.
Dispose()	Libera todos os recursos usados pelo ResXResourceWriter.
Dispose(Boolean)	Libera os recursos não gerenciados usados pelo ResXResourceWriter e opcionalmente libera os recursos gerenciados.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Finalize()	Esse membro substitui o método Finalize().
Generate()	Grava todos os recursos adicionados pelo método AddResource(String, Byte[]) no arquivo de saída ou no fluxo.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Confira também

Trabalhando com arquivos .resx de forma programática

Compartilhar via