ResourceWriter Clase

Referencia

Definición

Espacio de nombres:: System.Resources

Ensamblado:: System.Resources.Writer.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Escribe recursos en el formato predeterminado del sistema para un archivo de resultados o un flujo de salida. Esta clase no puede heredarse.

public ref class ResourceWriter sealed : IDisposable, System::Resources::IResourceWriter

public ref class ResourceWriter sealed : IDisposable

public ref class ResourceWriter sealed : System::Resources::IResourceWriter

public sealed class ResourceWriter : IDisposable, System.Resources.IResourceWriter

public sealed class ResourceWriter : IDisposable

public sealed class ResourceWriter : System.Resources.IResourceWriter

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ResourceWriter : System.Resources.IResourceWriter

type ResourceWriter = class
    interface IDisposable
    interface IResourceWriter

type ResourceWriter = class
    interface IDisposable

type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable

[<System.Runtime.InteropServices.ComVisible(true)>]
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable

Public NotInheritable Class ResourceWriter
Implements IDisposable, IResourceWriter

Public NotInheritable Class ResourceWriter
Implements IDisposable

Public NotInheritable Class ResourceWriter
Implements IResourceWriter

Herencia: Object
ResourceWriter

Atributos: ComVisibleAttribute

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 IResourceWriter interfaz. Permite crear mediante programación un archivo de recursos binarios (.resources).

Los recursos se especifican como pares de nombre y valor mediante el AddResource método . 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 ayudar a eliminar errores, ResourceWriter no permitirá que un archivo .resources tenga nombres que solo varían según el caso. La ResourceWriter clase 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 utilizar el tipo, debe desecharlo directa o indirectamente. Para eliminar el tipo directamente, llame a su método Dispose en un bloque try/catch. Para deshacerse de él indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic). Para más información, vea la sección "Uso de objetos que implementan IDisposable" en el tema de la interfaz IDisposable.

Para crear un archivo de recursos, cree un ResourceWriter con un nombre de archivo único, llame AddResource al menos una vez, llame Generate a para escribir el archivo de recursos en el disco y, a continuación, llame Close a para cerrar el archivo. Al llamar Close a se llamará Generate implícitamente si no se 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 ResourceWriter clase , puede usar la ResourceManager clase , que le permite recuperar recursos con nombre o la ResourceReader clase , 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 en versiones de destino de .NET Framework anteriores a .NET Framework 4 usando nombres de ensamblado calificados.

Métodos

AddResource(String, Byte[])	Agrega un recurso con nombre, especificado como una matriz de bytes, a la lista de recursos que se va a escribir.
AddResource(String, Object)	Agrega un recurso con nombre, especificado como una matriz de bytes, a la lista de recursos que se va a escribir.
AddResource(String, Stream)	Agrega un recurso con nombre, especificado como una secuencia, a la lista de recursos que se va 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, String)	Agrega un recurso de cadena a la lista de recursos que se va a escribir.
AddResourceData(String, String, Byte[])	Agrega una unidad de datos como recurso a la lista de recursos que se va a escribir.
Close()	Guarda los recursos en el flujo de salida y, a continuación, lo cierra.
Dispose()	Permite a los usuarios cerrar el flujo o el archivo de recursos y liberar los recursos de forma explícita.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Generate()	Guarda todos los recursos en el flujo de salida con el formato predeterminado del sistema.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Se aplica a