ResourceWriter Classe

Definição

Namespace:

System.Resources

Assembly:

System.Resources.Writer.dll

Origem:

ResourceWriter.cs

Grava recursos no formato padrão do sistema em um arquivo de saída ou um fluxo de saída. Essa classe não pode ser herdada.

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

Herança

Object

ResourceWriter

Implementações

IDisposable IResourceWriter

Exemplos

O exemplo a seguir grava várias cadeias de caracteres no arquivo 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

Comentários

ResourceWriter fornece uma implementação padrão da IResourceWriter interface . Ele permite que você crie programaticamente um arquivo de recurso binário (.resources).

Os recursos são especificados como pares de nome e 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, ResourceWriter não permitirá que um arquivo .resources tenha nomes que variam apenas por caso. A ResourceWriter classe permite que você crie cadeia de caracteres, objeto e recursos binários. Os recursos binários podem ser gravados no arquivo de recurso como uma matriz de bytes ou um fluxo.

Importante

Esse tipo implementa a interface IDisposable. Quando você terminar de usar o tipo, deverá descartá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame o método Dispose dele em um bloco try/catch. Para descartá-lo indiretamente, use um constructo de linguagem como using ( em C#) ou Using (em Visual Basic). Saiba mais na seção "Como usar um objeto que implementa IDisposable" no tópico da interface IDisposable.

Para criar um arquivo de recursos, crie um ResourceWriter com um nome de arquivo exclusivo, chame AddResource pelo menos uma vez, chame Generate para gravar o arquivo de recursos no disco e, em seguida, chame Close para fechar o arquivo. Chamar Close chamará Generate implicitamente se você não chamar Generateexplicitamente .

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

Para recuperar recursos de um arquivo .resources binário criado pela ResourceWriter classe , você pode usar a ResourceManager classe , que permite recuperar recursos nomeados ou a ResourceReader classe , que permite enumerar todos os recursos no arquivo.

Construtores

ResourceWriter(Stream)	Inicializa uma nova instância da classe ResourceWriter que grava os recursos no fluxo fornecido.
ResourceWriter(String)	Inicializa uma nova instância da classe ResourceWriter que grava os recursos no arquivo especificado.

Propriedades

TypeNameConverter

Obtém ou define um delegado que habilita os assemblies de recurso a serem gravados que direcionam versões do .NET Framework antes do .NET Framework 4 usando nomes de assembly qualificados.

Métodos

AddResource(String, Byte[])	Adiciona um recurso nomeado especificado como uma matriz de bytes para a lista de recursos a serem gravados.
AddResource(String, Object)	Adiciona um recurso nomeado especificado como um objeto para a lista de recursos a serem gravados.
AddResource(String, Stream)	Adiciona um recurso nomeado especificado como um fluxo à lista de recursos a serem gravados.
AddResource(String, Stream, Boolean)	Adiciona um recurso nomeado especificado como um fluxo à lista de recursos a serem gravados e especifica se o fluxo deverá ser fechado depois que o método Generate() for chamado.
AddResource(String, String)	Adiciona um recurso de cadeia de caracteres à lista de recursos a ser gravado.
AddResourceData(String, String, Byte[])	Adiciona uma unidade de dados como um recurso à lista de recursos a serem gravados.
Close()	Salva os recursos no fluxo de saída e, em seguida, o fecha.
Dispose()	Permite que os usuários fechem o fluxo ou o arquivo de recurso, liberando recursos explicitamente.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Generate()	Salva todos os recursos no fluxo de saída no formato padrão do sistema.
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)

Confira também

• IResourceWriter
• IDisposable
• Recursos em aplicativos de área de trabalho
• Criar arquivos de recursos para aplicativos de área de trabalho