ResXResourceSet Clase

Definición

Representa todos los recursos de un archivo de recursos XML (.resx).Represents all resources in an XML resource (.resx) file.

public ref class ResXResourceSet : System::Resources::ResourceSet
public class ResXResourceSet : System.Resources.ResourceSet
type ResXResourceSet = class
    inherit ResourceSet
Public Class ResXResourceSet
Inherits ResourceSet
Herencia
ResXResourceSet

Ejemplos

En el ejemplo siguiente se crea una instancia de un ResXResourceSet objeto y se muestra cómo enumerar sus recursos y recuperar recursos individuales por nombre.The following example instantiates a ResXResourceSet object and illustrates how to enumerate its resources and retrieve individual resources by name. Para cada recurso que enumera, en el ejemplo se usa la IDictionaryEnumerator.Key propiedad en una llamada al GetString método o GetObject , dependiendo de si el valor del recurso es una cadena o un objeto.For each resource that it enumerates, the example uses the IDictionaryEnumerator.Key property in a call to the GetString or GetObject method, depending on whether the value of the resource is a string or an object.

using System;
using System.Collections;
using System.Drawing;
using System.Resources;

public class Example
{
   public static void Main()
   {
      CreateResXFile();
      
      ResXResourceSet resSet = new ResXResourceSet(@".\StoreResources.resx");
      IDictionaryEnumerator dict = resSet.GetEnumerator();
      while (dict.MoveNext()) {
         string key = (string) dict.Key;
         // Retrieve resource by name.
         if (dict.Value is string)
            Console.WriteLine("{0}: {1}", key, resSet.GetString(key));
         else
            Console.WriteLine("{0}: {1}", key, resSet.GetObject(key));   
      }
   }

   private static void CreateResXFile()
   {
      Bitmap logo = new Bitmap(@".\Logo.bmp");
      ResXDataNode node;
      
      ResXResourceWriter rw = new ResXResourceWriter(@".\StoreResources.resx");
      node = new ResXDataNode("Logo", logo);
      node.Comment = "The corporate logo.";
      rw.AddResource(node); 
      rw.AddResource("AppTitle", "Store Locations");
      node = new ResXDataNode("nColumns", 5);
      node.Comment = "The number of columns in the Store Location table";
      rw.AddResource(node);
      rw.AddResource("City", "City");
      rw.AddResource("State", "State");
      rw.AddResource("Code", "Zip Code");
      rw.AddResource("Telephone", "Phone");
      rw.Generate();
      rw.Close();
   }
}
// The example displays the following output:
//       Telephone: Phone
//       Code: Zip Code
//       State: State
//       City: City
//       nColumns: 5
//       AppTitle: Store Locations
//       Logo: System.Drawing.Bitmap
Imports System.Collections
Imports System.Drawing
Imports System.Resources

Module Example
   Public Sub Main()
      CreateResXFile()
      
      Dim resSet As New ResXResourceSet(".\StoreResources.resx")
      Dim dict As IDictionaryEnumerator = resSet.GetEnumerator()
      Do While dict.MoveNext()
         Dim key As String = CStr(dict.Key)
         ' Retrieve resource by name.
         If typeof dict.Value Is String Then
            Console.WriteLine("{0}: {1}", key, resSet.GetString(key))
         Else
            Console.WriteLine("{0}: {1}", key, resSet.GetObject(key))   
         End If
      Loop
   End Sub
   
   Private Sub CreateResXFile()
      Dim logo As New Bitmap(".\Logo.bmp")
      Dim node As ResXDataNode
      
      Dim rw As New ResXResourceWriter(".\StoreResources.resx")
      node = New ResXDataNode("Logo", logo)
      node.Comment = "The corporate logo."
      rw.AddResource(node) 
      rw.AddResource("AppTitle", "Store Locations")
      node = New ResXDataNode("nColumns", 5)
      node.Comment = "The number of columns in the Store Location table"
      rw.AddResource(node)
      rw.AddResource("City", "City")
      rw.AddResource("State", "State")
      rw.AddResource("Code", "Zip Code")
      rw.AddResource("Telephone", "Phone")
      rw.Generate()
      rw.Close()
   End Sub
End Module
' The example displays the following output:
'       Telephone: Phone
'       Code: Zip Code
'       State: State
'       City: City
'       nColumns: 5
'       AppTitle: Store Locations
'       Logo: System.Drawing.Bitmap

En el ejemplo se llama a un CreateResXFile método para crear el archivo de recursos XML necesario.The example calls a CreateResXFile method to create the necessary XML resource file. Requiere un archivo de mapa de bits denominado Logo.bmp en el directorio en el que se ejecuta el ejemplo.It requires a bitmap file named Logo.bmp in the directory in which the example is running.

Comentarios

La ResXResourceSet clase enumera en IResourceReader , carga cada nombre y valor, y los almacena en una tabla hash.The ResXResourceSet class enumerates over an IResourceReader, loads every name and value, and stores them in a hash table. A continuación, puede enumerar los recursos del ResXResourceSet objeto o recuperar los recursos individuales por nombre.You can then enumerate the resources in the ResXResourceSet object or retrieve individual resources by name.

Nota

Esta clase contiene un SecurityAction.LinkDemand y un SecurityAction.InheritanceDemand en el nivel de clase que se aplica a todos los miembros.This class contains a SecurityAction.LinkDemand and an SecurityAction.InheritanceDemand at the class level that applies to all members. SecurityExceptionSe produce una excepción cuando el llamador inmediato o una clase derivada no tienen permiso de plena confianza.A SecurityException exception is thrown when the immediate caller or a derived class does not have full-trust permission.

Un ResXResourceSet objeto proporciona una manera cómoda de leer todos los recursos de un archivo. resx en la memoria.A ResXResourceSet object provides a convenient way to read all the resources in a .resx file into memory. Puede usar el GetObject método para recuperar un recurso determinado cuando se ha leído el archivo. resx en una ResXResourceSet instancia de.You can use the GetObject method to retrieve a particular resource when the .resx file has been read into a ResXResourceSet instance.

Notas a los desarrolladores de herederos

Las clases derivadas de ResXResourceSet que usan su propio lector y escritor de recursos deben invalidar los GetDefaultReader() GetDefaultWriter() métodos y para proporcionar la funcionalidad adecuada para interpretar la ResXResourceSet instancia.Derived classes of ResXResourceSet that use their own resource reader and writer should override the GetDefaultReader() and GetDefaultWriter() methods to provide the appropriate functionality for interpreting the ResXResourceSet instance.

Constructores

ResXResourceSet(Stream)

Inicializa una nueva instancia de la clase ResXResourceSet usando el ResXResourceReader predeterminado del sistema para leer los recursos del flujo especificado.Initializes a new instance of the ResXResourceSet class using the system default ResXResourceReader to read resources from the specified stream.

ResXResourceSet(String)

Inicializa una nueva instancia de una clase ResXResourceSet usando el ResXResourceReader predeterminado del sistema, que abre y lee los recursos de un archivo especificado.Initializes a new instance of a ResXResourceSet class using the system default ResXResourceReader that opens and reads resources from the specified file.

Campos

Reader

Indica el elemento IResourceReader usado para leer los recursos.Indicates the IResourceReader used to read the resources.

(Heredado de ResourceSet)
Table

Hashtable donde se almacenan los recursos.The Hashtable in which the resources are stored.

(Heredado de ResourceSet)

Métodos

Close()

Cierra y libera cualquier recurso usado por este ResourceSet.Closes and releases any resources used by this ResourceSet.

(Heredado de ResourceSet)
Dispose()

Se deshace de los recursos (distintos de la memoria) usados por la instancia actual de ResourceSet.Disposes of the resources (other than memory) used by the current instance of ResourceSet.

(Heredado de ResourceSet)
Dispose(Boolean)

Libera los recursos (distintos de la memoria) asociados a la instancia actual, cerrando objetos administrados internos si fuera necesario.Releases resources (other than memory) associated with the current instance, closing internal managed objects if requested.

(Heredado de ResourceSet)
Equals(Object)

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

(Heredado de Object)
GetDefaultReader()

Devuelve la clase del lector de recursos preferido de esta categoría de ResXResourceSet.Returns the preferred resource reader class for this kind of ResXResourceSet.

GetDefaultWriter()

Devuelve la clase del escritor de recursos preferido de esta categoría de ResXResourceSet.Returns the preferred resource writer class for this kind of ResXResourceSet.

GetEnumerator()

Devuelve una interfaz IDictionaryEnumerator que puede recorrer en iteración el ResourceSet.Returns an IDictionaryEnumerator that can iterate through the ResourceSet.

(Heredado de ResourceSet)
GetHashCode()

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

(Heredado de Object)
GetObject(String)

Busca un objeto de recursos con el nombre especificado.Searches for a resource object with the specified name.

(Heredado de ResourceSet)
GetObject(String, Boolean)

Busca un objeto de recursos con el nombre especificado de forma que no distinga entre mayúsculas y minúsculas, si así se solicitase.Searches for a resource object with the specified name in a case-insensitive manner, if requested.

(Heredado de ResourceSet)
GetString(String)

Busca un recurso de tipo String con el nombre especificado.Searches for a String resource with the specified name.

(Heredado de ResourceSet)
GetString(String, Boolean)

Busca un recurso de tipo String con el nombre especificado de forma que no distinga entre mayúsculas y minúsculas, si así se solicitase.Searches for a String resource with the specified name in a case-insensitive manner, if requested.

(Heredado de ResourceSet)
GetType()

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

(Heredado de Object)
MemberwiseClone()

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

(Heredado de Object)
ReadResources()

Lee todos los recursos y los almacena en una Hashtable tal y como se indica en la propiedad Table.Reads all the resources and stores them in a Hashtable indicated in the Table property.

(Heredado de ResourceSet)
ToString()

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

(Heredado de Object)

Implementaciones de interfaz explícitas

IEnumerable.GetEnumerator()

Devuelve un objeto IEnumerator para evitar una condición de carrera con Dispose.Returns an IEnumerator object to avoid a race condition with Dispose. Este miembro no está pensado para usarlo directamente desde el código.This member is not intended to be used directly from your code.

(Heredado de ResourceSet)

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a