ResourceWriter ResourceWriter ResourceWriter ResourceWriter Class

Definición

Escribe recursos en el formato predeterminado del sistema para un archivo de resultados o un flujo de salida.Writes resources in the system-default format to an output file or an output stream. Esta clase no puede heredarse.This class cannot be inherited.

public ref class ResourceWriter sealed : System::Resources::IResourceWriter
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ResourceWriter : System.Resources.IResourceWriter
type ResourceWriter = class
    interface IResourceWriter
    interface IDisposable
Public NotInheritable Class ResourceWriter
Implements IResourceWriter
Herencia
ResourceWriterResourceWriterResourceWriterResourceWriter
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se escriben varias cadenas en el archivo MyResources. Resources.The following example writes several strings into the myResources.resources file.

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

ResourceWriterproporciona una implementación predeterminada de la IResourceWriter interfaz.ResourceWriter provides a default implementation of the IResourceWriter interface. Permite crear un archivo de recursos binario (. Resources) mediante programación.It enables you to programmatically create a binary resource (.resources) file.

Los recursos se especifican como pares de nombre y AddResource valor mediante el método.Resources are specified as name and value pairs using the AddResource method. Los nombres de los recursos distinguen mayúsculas de minúsculas cuando se usan para búsquedas, pero para facilitar la compatibilidad con las ResourceWriter herramientas de creación y ayudar a eliminar errores, no permitirá que un archivo. Resources tenga nombres que solo varíen por mayúsculas y minúsculas.Resource names are case-sensitive when used for lookups, but to more easily support authoring tools and help eliminate bugs, ResourceWriter will not allow a .resources file to have names that vary only by case. La ResourceWriter clase le permite crear recursos de cadena, objeto y binario.The ResourceWriter class enables you to create string, object, and binary resources. Los recursos binarios se pueden escribir en el archivo de recursos como una matriz de bytes o una secuencia.Binary resources can be written to the resource file as a byte array or a stream.

Importante

Este tipo implementa la interfaz IDisposable.This type implements the IDisposable interface. Cuando haya terminado de utilizar el tipo, debe desecharlo directa o indirectamente.When you have finished using the type, you should dispose of it either directly or indirectly. Para eliminar el tipo directamente, llame a su método Dispose en un bloque try/catch.To dispose of the type directly, call its Dispose method in a try/catch block. Para deshacerse de él indirectamente, use una construcción de lenguaje como using (en C#) o Using (en Visual Basic).To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). Para más información, vea la sección "Uso de objetos que implementan IDisposable" en el tema de la interfaz IDisposable.For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

Para crear un archivo de recursos, cree ResourceWriter un con un nombre de archivo único AddResource , llame al menos una Generate vez, llame a para escribir el archivo de recursos en Close el disco y, a continuación, llame a para cerrar el archivo.To create a resources file, create a ResourceWriter with a unique file name, call AddResource at least once, call Generate to write the resources file to disk, and then call Close to close the file. Al Close llamar a, se Generate llamará implícitamente a si Generateno se llama explícitamente a.Calling Close will implicitly call Generate if you do not explicitly call Generate.

Los recursos no se escribirán necesariamente en el mismo orden en que se agregaron.The resources will not necessarily be written in the same order they were added.

Para recuperar recursos de un archivo. Resources binario ResourceWriter creado por la clase, puede ResourceManager usar la clase, que permite recuperar recursos con nombre o ResourceReader la clase, que permite enumerar todos los recursos del archivo.To retrieve resources from a binary .resources file created by the ResourceWriter class, you can use the ResourceManager class, which lets you retrieve named resources, or the ResourceReader class, which lets you enumerate all the resources in the file.

Constructores

ResourceWriter(Stream) ResourceWriter(Stream) ResourceWriter(Stream) ResourceWriter(Stream)

Inicializa una nueva instancia de la clase ResourceWriter que escribe los recursos en el flujo proporcionado.Initializes a new instance of the ResourceWriter class that writes the resources to the provided stream.

ResourceWriter(String) ResourceWriter(String) ResourceWriter(String) ResourceWriter(String)

Inicializa una nueva instancia de la clase ResourceWriter que escribe los recursos en el archivo especificado.Initializes a new instance of the ResourceWriter class that writes the resources to the specified file.

Propiedades

TypeNameConverter TypeNameConverter TypeNameConverter TypeNameConverter

Obtiene o establece un delegado que permite escribir ensamblados de recursos en versiones de destino de .NET Framework anteriores a .NET Framework 4.NET Framework 4 usando nombres de ensamblado calificados.Gets or sets a delegate that enables resource assemblies to be written that target versions of the .NET Framework prior to the .NET Framework 4.NET Framework 4 by using qualified assembly names.

Métodos

AddResource(String, Byte[]) AddResource(String, Byte[]) AddResource(String, Byte[]) AddResource(String, Byte[])

Agrega un recurso con nombre, especificado como una matriz de bytes, a la lista de recursos que se va a escribir.Adds a named resource specified as a byte array to the list of resources to be written.

AddResource(String, Object) AddResource(String, Object) AddResource(String, Object) AddResource(String, Object)

Agrega un recurso con nombre, especificado como una matriz de bytes, a la lista de recursos que se va a escribir.Adds a named resource specified as an object to the list of resources to be written.

AddResource(String, Stream) AddResource(String, Stream) AddResource(String, Stream) AddResource(String, Stream)

Agrega un recurso con nombre, especificado como una secuencia, a la lista de recursos que se va a escribir.Adds a named resource specified as a stream to the list of resources to be written.

AddResource(String, Stream, Boolean) AddResource(String, Stream, Boolean) AddResource(String, Stream, Boolean) 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().Adds a named resource specified as a stream to the list of resources to be written, and specifies whether the stream should be closed after the Generate() method is called.

AddResource(String, String) AddResource(String, String) AddResource(String, String) AddResource(String, String)

Agrega un recurso de cadena a la lista de recursos que se va a escribir.Adds a string resource to the list of resources to be written.

AddResourceData(String, String, Byte[]) AddResourceData(String, String, Byte[]) AddResourceData(String, String, Byte[]) AddResourceData(String, String, Byte[])

Agrega una unidad de datos como recurso a la lista de recursos que se va a escribir.Adds a unit of data as a resource to the list of resources to be written.

Close() Close() Close() Close()

Guarda los recursos en el flujo de salida y, a continuación, lo cierra.Saves the resources to the output stream and then closes it.

Dispose() Dispose() Dispose() Dispose()

Permite a los usuarios cerrar el flujo o el archivo de recursos y liberar los recursos de forma explícita.Allows users to close the resource file or stream, explicitly releasing resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Generate() Generate() Generate() Generate()

Guarda todos los recursos en el flujo de salida con el formato predeterminado del sistema.Saves all resources to the output stream in the system default format.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: