ResourceWriter Clase

Definición

Espacio de nombres:

System.Resources

Ensamblado:

System.Resources.Writer.dll

Source:

ResourceWriter.cs

Escribe recursos en el formato predeterminado del sistema en un archivo de salida o en un flujo de salida. Esta clase no se puede heredar.

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

Herencia

Object

ResourceWriter

Implementaciones

IDisposable IResourceWriter

Ejemplos

En el ejemplo siguiente se escriben varias cadenas en el archivo 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

Comentarios

ResourceWriter proporciona una implementación predeterminada de la interfaz IResourceWriter. Permite crear mediante programación un archivo de recursos binarios (.resources).

Los recursos se especifican como pares de nombre y valor mediante el método AddResource. Los nombres de recursos distinguen mayúsculas de minúsculas cuando se usan para búsquedas, pero para admitir más fácilmente las herramientas de creación y ayudan a eliminar errores, ResourceWriter no permitirá que un archivo .resources tenga nombres que varían solo por caso. La clase ResourceWriter permite crear recursos binarios, objetos y cadenas. Los recursos binarios se pueden escribir en el archivo de recursos como una matriz de bytes o una secuencia.

Importante

Este tipo implementa la interfaz IDisposable. Cuando haya terminado de usar el tipo, debe eliminarlo directa o indirectamente. Para eliminar el tipo directamente, llame a su método Dispose en un bloque try/catch. Para eliminarlo indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para obtener más información, vea la sección "Using an Object that Implements IDisposable" (Usar un objeto que implementa IDisposable) en el tema IDisposable interfaz.

Para crear un archivo de recursos, cree un ResourceWriter con un nombre de archivo único, llame a AddResource al menos una vez, llame a Generate para escribir el archivo de recursos en el disco y, a continuación, llame a Close para cerrar el archivo. Al llamar a Close se llamará implícitamente a Generate si no llama explícitamente a Generate.

Los recursos no se escribirán necesariamente en el mismo orden en que se agregaron.

Para recuperar recursos de un archivo .resources binario creado por la clase ResourceWriter, puede usar la clase ResourceManager, que permite recuperar recursos con nombre o la clase ResourceReader, lo que le permite enumerar todos los recursos del archivo.

Constructores

ResourceWriter(Stream)	Inicializa una nueva instancia de la clase ResourceWriter que escribe los recursos en la secuencia proporcionada.
ResourceWriter(String)	Inicializa una nueva instancia de la clase ResourceWriter que escribe los recursos en el archivo especificado.

Propiedades

TypeNameConverter

Obtiene o establece un delegado que permite escribir ensamblados de recursos que tienen como destino versiones de .NET Framework anteriores a .NET Framework 4 mediante nombres de ensamblado completos.

Métodos

AddResource(String, Byte[])	Agrega un recurso con nombre especificado como una matriz de bytes a la lista de recursos que se van a escribir.
AddResource(String, Object)	Agrega un recurso con nombre especificado como un objeto a la lista de recursos que se van a escribir.
AddResource(String, Stream, Boolean)	Agrega un recurso con nombre especificado como una secuencia a la lista de recursos que se va a escribir y especifica si se debe cerrar la secuencia después de llamar al método Generate().
AddResource(String, Stream)	Agrega un recurso con nombre especificado como una secuencia a la lista de recursos que se van a escribir.
AddResource(String, String)	Agrega un recurso de cadena a la lista de recursos que se van a escribir.
AddResourceData(String, String, Byte[])	Agrega una unidad de datos como un recurso a la lista de recursos que se van a escribir.
Close()	Guarda los recursos en el flujo de salida y, a continuación, lo cierra.
Dispose()	Permite a los usuarios cerrar el archivo de recursos o la secuencia, liberando explícitamente los recursos.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
Generate()	Guarda todos los recursos en el flujo de salida en el formato predeterminado del sistema.
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• IResourceWriter
• IDisposable
• recursos de en aplicaciones de escritorio
• crear archivos de recursos para aplicaciones de escritorio