ResourceWriter Classe

Definição

Espaço de Nomes:
System.Resources
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll

Escreve recursos no formato padrão do sistema num ficheiro de saída ou num fluxo de saída. Esta classe não pode ser herdada.

public ref class ResourceWriter sealed : System::Resources::IResourceWriter
public sealed class ResourceWriter : System.Resources.IResourceWriter
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ResourceWriter : System.Resources.IResourceWriter
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable
[<System.Runtime.InteropServices.ComVisible(true)>]
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable
type ResourceWriter = class
    interface IDisposable
    interface IResourceWriter
Public NotInheritable Class ResourceWriter
Implements IResourceWriter
Herança
Object
ResourceWriter
Atributos
ComVisibleAttribute
Implementações
IDisposable IResourceWriter

Exemplos

O exemplo seguinte escreve várias cadeias no ficheiro myResources.resources.

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

Observações

ResourceWriter fornece uma implementação padrão da IResourceWriter interface. Permite-te criar programaticamente um ficheiro binário de recursos (.resources).

Os recursos são especificados como pares de nome e valor usando o AddResource método. Os nomes dos recursos são sensíveis a maiúsculas e minúsculas quando usados para consultas, mas para suportar mais facilmente ferramentas de autoria e ajudar a eliminar bugs, ResourceWriter não permite que um ficheiro .resources tenha nomes que variem apenas consoante o caso. A ResourceWriter classe permite-lhe criar recursos de strings, objetos e binários. Recursos binários podem ser escritos no ficheiro de recurso como um array de bytes ou um fluxo.

Importante

Este tipo implementa a interface IDisposable. Quando terminar de usar o tipo, você deve eliminá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame seu método Dispose em um bloco try/catch. Para descartá-lo indiretamente, use uma construção de linguagem como using (em C#) ou Using (em Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa IDisposable" no tópico da IDisposable interface.

Para criar um ficheiro de recursos, cria um ResourceWriter com um nome de ficheiro único, chama AddResource pelo menos uma vez, chama Generate para escrever o ficheiro de recursos no disco e depois liga Close para fechar o ficheiro. Chamar Close irá implicitamente chamar Generate se não chamar explicitamente Generate.

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

Para recuperar recursos de um ficheiro binário .resources criado pela ResourceWriter classe, podes usar a ResourceManager class, que te permite recuperar recursos nomeados, ou a ResourceReader class, que te permite enumerar todos os recursos no ficheiro.

Construtores

Name Description
ResourceWriter(Stream)

Inicializa uma nova instância da ResourceWriter classe que escreve os recursos no fluxo fornecido.
ResourceWriter(String)

Inicializa uma nova instância da ResourceWriter classe que escreve os recursos no ficheiro especificado.

Propriedades

Name Description
TypeNameConverter

Obtém ou define um delegado que permite escrever assemblies de recursos que visam versões do .NET Framework antes do .NET Framework 4, utilizando nomes de assembly qualificados.

Métodos

Name Description
AddResource(String, Byte[])

Adiciona um recurso nomeado especificado como um array de bytes à lista de recursos a escrever.
AddResource(String, Object)

Adiciona um recurso nomeado especificado como objeto à lista de recursos a escrever.
AddResource(String, Stream, Boolean)

Adiciona um recurso nomeado especificado como fluxo à lista de recursos a escrever, e especifica se o fluxo deve ser fechado após o Generate() método ser chamado.
AddResource(String, Stream)

Adiciona um recurso nomeado especificado como fluxo à lista de recursos a escrever.
AddResource(String, String)

Adiciona um recurso string à lista de recursos a escrever.
AddResourceData(String, String, Byte[])

Adiciona uma unidade de dados como recurso à lista de recursos a escrever.
Close()

Guarda os recursos para o fluxo de saída e depois fecha-o.
Dispose()

Permite aos utilizadores fechar o ficheiro de recursos ou fluxo, libertando explicitamente recursos.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Generate()

Guarda todos os recursos para o fluxo de saída no formato padrão do sistema.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também