ResourceManager ResourceManager ResourceManager ResourceManager Constructors

Definición

Sobrecargas

ResourceManager() ResourceManager() ResourceManager()

Inicializa una nueva instancia de la clase ResourceManager con valores predeterminados.Initializes a new instance of the ResourceManager class with default values.

ResourceManager(Type) ResourceManager(Type) ResourceManager(Type) ResourceManager(Type)

Inicializa una nueva instancia de la clase ResourceManager que busca recursos en los ensamblados satélite a partir de la información del objeto de tipo especificado.Initializes a new instance of the ResourceManager class that looks up resources in satellite assemblies based on information from the specified type object.

ResourceManager(String, Assembly) ResourceManager(String, Assembly) ResourceManager(String, Assembly)

Inicializa una nueva instancia de la clase ResourceManager que busca los recursos que contienen los archivos con el nombre raíz especificado, en el objeto dado.Initializes a new instance of the ResourceManager class that looks up resources contained in files with the specified root name in the given assembly.

ResourceManager(String, Assembly, Type) ResourceManager(String, Assembly, Type) ResourceManager(String, Assembly, Type)

Inicializa una nueva instancia de la clase ResourceManager que usa un ResourceSet especificado para buscar recursos que contenga archivos con el nombre de raíz especificado en el ensamblado determinado.Initializes a new instance of the ResourceManager class that uses a specified ResourceSet class to look up resources contained in files with the specified root name in the given assembly.

ResourceManager() ResourceManager() ResourceManager()

Inicializa una nueva instancia de la clase ResourceManager con valores predeterminados.Initializes a new instance of the ResourceManager class with default values.

protected:
 ResourceManager();
protected ResourceManager ();
Protected Sub New ()

Comentarios

Este constructor solo es útil si escribir su propia clase que deriva la ResourceManager clase.This constructor is useful only if you write your own class that derives from the ResourceManager class.

ResourceManager(Type) ResourceManager(Type) ResourceManager(Type) ResourceManager(Type)

Inicializa una nueva instancia de la clase ResourceManager que busca recursos en los ensamblados satélite a partir de la información del objeto de tipo especificado.Initializes a new instance of the ResourceManager class that looks up resources in satellite assemblies based on information from the specified type object.

public:
 ResourceManager(Type ^ resourceSource);
public ResourceManager (Type resourceSource);
new System.Resources.ResourceManager : Type -> System.Resources.ResourceManager
Public Sub New (resourceSource As Type)

Parámetros

resourceSource
Type Type Type Type

Tipo a partir del cual el administrador de recursos deriva toda la información para buscar archivos .resources.A type from which the resource manager derives all information for finding .resources files.

Excepciones

El parámetro resourceSource es null.The resourceSource parameter is null.

Ejemplos

En el ejemplo siguiente se usa el ResourceManager(Type) constructor para crear instancias de un ResourceManager objeto.The following example uses the ResourceManager(Type) constructor to instantiate a ResourceManager object. Consta de los recursos compilados desde archivos .txt de inglés (en), francés (Francia) (fr-FR) y ruso (Rusia) (ru-RU), las referencias culturales.It consists of resources compiled from .txt files for the English (en), French (France) (fr-FR), and Russian (Russia) (ru-RU) cultures. El ejemplo cambia la referencia cultural actual y la referencia cultural de interfaz de usuario actual para inglés (Estados Unidos), francés (Francia), ruso (Rusia) y sueco (Suecia).The example changes the current culture and current UI culture to English (United States), French (France), Russian (Russia), and Swedish (Sweden). A continuación, llama el GetString(String) método para recuperar la cadena localizada, que mostrará un saludo que depende de la hora del día.It then calls the GetString(String) method to retrieve the localized string, which displays a greeting that depends on the time of day.

El ejemplo requiere tres archivos de recursos basado en texto, como se muestra en la tabla siguiente.The example requires three text-based resource files, as listed in the following table. Cada archivo incluye recursos de cadena denominados Morning, Afternoon, y Evening.Each file includes string resources named Morning, Afternoon, and Evening.

cultureCulture Nombre del archivoFile name Nombre del recursoResource name Valor del recursoResource value
en-USen-US GreetingResources.txtGreetingResources.txt Morning Buenos díasGood morning
en-USen-US GreetingResources.txtGreetingResources.txt Afternoon Buenas tardesGood afternoon
en-USen-US GreetingResources.txtGreetingResources.txt Evening Buenas nochesGood evening
fr-FRfr-FR GreetingResources.fr-FR.txtGreetingResources.fr-FR.txt Morning BonjourBonjour
fr-FRfr-FR GreetingResources.fr-FR.txtGreetingResources.fr-FR.txt Afternoon BonjourBonjour
fr-FRfr-FR GreetingResources.fr-FR.txtGreetingResources.fr-FR.txt Evening BonsoirBonsoir
ru-RUru-RU GreetingResources.ru-RU. txtGreetingResources.ru-RU.txt Morning ДОБРОЕ УТРОДоброе утро
ru-RUru-RU GreetingResources.ru-RU. txtGreetingResources.ru-RU.txt Afternoon ДОБРЫЙ ДЕНЬДобрый день
ru-RUru-RU GreetingResources.ru-RU. txtGreetingResources.ru-RU.txt Evening ДОБРЫЙ ВЕЧЕРДобрый вечер

Puede usar el siguiente archivo por lotes para compilar el ejemplo de Visual Basic y crear un archivo ejecutable denominado Greet.exe.You can use the following batch file to compile the Visual Basic example and create an executable named Greet.exe. Para compilar con C#, cambie el nombre del compilador de vbc a csc y la extensión de archivo de .vb a .cs.To compile with C#, change the compiler name from vbc to csc and the file extension from .vb to .cs.


resgen GreetingResources.txt  
vbc Greet.vb /resource: GreetingResources.resources  

md fr-FR  
resgen GreetingResources.fr-FR.txt  
al /out:fr-FR\Greet.resources.dll /culture:fr-FR /embed: GreetingResources.fr-FR.resources   

md ru-RU  
resgen GreetingResources.ru-RU.txt  
al /out:ru-RU\Greet.resources.dll /culture:ru-RU /embed: GreetingResources.ru-RU.resources  

Este es el código fuente para el ejemplo (ShowDate.vb para la versión de Visual Basic) o ShowDate.cs para la versión de C# del código.Here's the source code for the example (ShowDate.vb for the Visual Basic version or ShowDate.cs for the C# version of the code).

using System;
using System.Resources;
using System.Globalization;
using System.Threading;

[assembly:NeutralResourcesLanguage("en")]

public class Example
{
   public static void Main()
   {
      string[] cultureNames = {"en-US", "fr-FR", "ru-RU", "sv-SE" };
      DateTime noon = new DateTime(DateTime.Now.Year, DateTime.Now.Month, 
                                   DateTime.Now.Day, 12,0,0);
      DateTime evening = new DateTime(DateTime.Now.Year, DateTime.Now.Month,
                                      DateTime.Now.Day, 18, 0, 0);                          
      
      ResourceManager rm = new ResourceManager(typeof(GreetingResources));
      
      foreach (var cultureName in cultureNames) {
         Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(cultureName);
         Console.WriteLine("The current UI culture is {0}", 
                           CultureInfo.CurrentUICulture.Name);
         if (DateTime.Now < noon)
            Console.WriteLine("{0}!", rm.GetString("Morning"));
         else if (DateTime.Now < evening)
            Console.WriteLine("{0}!", rm.GetString("Afternoon"));
         else
            Console.WriteLine("{0}!", rm.GetString("Evening"));
         Console.WriteLine();
      }
   }

   internal class GreetingResources
   {
   }
}
// The example displays output like the following:
//       The current UI culture is en-US
//       Good afternoon!
//       
//       The current UI culture is fr-FR
//       Bonjour!
//       
//       The current UI culture is ru-RU
//       Добрый день!
//       
//       The current UI culture is sv-SE
//       Good afternoon!
Imports System.Resources
Imports System.Globalization
Imports System.Threading

<Assembly:NeutralResourcesLanguage("en")>

Module Example
   Public Sub Main()
      Dim cultureNames() As String = {"en-US", "fr-FR", "ru-RU", "sv-SE" }
      Dim noon As New Date(Date.Now.Year, Date.Now.Month, 
                           Date.Now.Day, 12,0,0)
      Dim evening As New Date(Date.Now.Year, Date.Now.Month,
                              Date.Now.Day, 18, 0, 0)                          
      
      Dim rm As New ResourceManager(GetType(GreetingResources))
      
      For Each cultureName In cultureNames
         Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(cultureName)
         Console.WriteLine("The current UI culture is {0}", 
                           CultureInfo.CurrentUICulture.Name)
         If Date.Now < noon Then
            Console.WriteLine("{0}!", rm.GetString("Morning"))
         ElseIf Date.Now < evening Then
            Console.WriteLine("{0}!", rm.GetString("Afternoon"))
         Else
            Console.WriteLine("{0}!", rm.GetString("Evening"))
         End If 
         Console.WriteLine()
      Next
   End Sub
End Module

Friend Class GreetingResources
End Class
' The example displays output like the following:
'       The current UI culture is en-US
'       Good afternoon!
'       
'       The current UI culture is fr-FR
'       Bonjour!
'       
'       The current UI culture is ru-RU
'       Добрый день!
'       
'       The current UI culture is sv-SE
'       Good afternoon!

Además de definir una clase de aplicación denominado Example, el código fuente define una clase interna cuyo nombre, GreetingResources, es el mismo que el nombre de la base de los archivos de recursos.In addition to defining an app class named Example, the source code defines an internal class whose name, GreetingResources, is the same as the base name of the resource files. Esto hace posible crear instancias de correctamente un ResourceManager objeto mediante una llamada a la ResourceManager(Type) constructor.This makes it possible to successfully instantiate a ResourceManager object by calling the ResourceManager(Type) constructor.

Tenga en cuenta que la salida muestra localizado adecuado cadena excepto cuando la referencia cultural de interfaz de usuario actual es Sueco (Suecia), en cuyo caso utiliza recursos del idioma inglés.Notice that the output displays the appropriate localized string except when the current UI culture is Swedish (Sweden), in which case it uses English language resources. Dado que los recursos de idioma sueco están disponibles, la aplicación usa los recursos de la referencia cultural predeterminada, tal como se define por la NeutralResourcesLanguageAttribute atributo, en su lugar.Because Swedish language resources are unavailable, the app uses the resources of the default culture, as defined by the NeutralResourcesLanguageAttribute attribute, instead.

Comentarios

Aplicaciones de escritorioDesktop Apps

En las aplicaciones de escritorio, el Administrador de recursos usa la resourceSource parámetro para cargar un archivo de recursos determinado como sigue:In desktop apps, the resource manager uses the resourceSource parameter to load a particular resource file as follows:

  • Si el NeutralResourcesLanguageAttribute atributo no se utiliza para indicar que los recursos de la referencia cultural predeterminada residen en un ensamblado satélite, el Administrador de recursos, se da por supuesto que el archivo de recursos para la referencia cultural predeterminada se encuentra en el mismo ensamblado que el tipo especificado por el resourceSource parámetro.If the NeutralResourcesLanguageAttribute attribute is not used to indicate that the resources of the default culture reside in a satellite assembly, the resource manager assumes that the resource file for the default culture is found in the same assembly as the type specified by the resourceSource parameter.

  • El Administrador de recursos, se da por supuesto que el archivo de recursos predeterminado tiene el mismo nombre base que el tipo especificado por el resourceSource parámetro.The resource manager assumes that the default resource file has the same base name as the type specified by the resourceSource parameter.

  • El Administrador de recursos usa el valor predeterminado ResourceSet clase para manipular el archivo de recursos.The resource manager uses the default ResourceSet class to manipulate the resource file.

Por ejemplo, dado un tipo denominado MyCompany.MyProduct.MyType, busca el Administrador de recursos para un archivo .resources denominado MyCompany.MyProduct.MyType.resources en el ensamblado que define MyType.For example, given a type named MyCompany.MyProduct.MyType, the resource manager looks for a .resources file named MyCompany.MyProduct.MyType.resources in the assembly that defines MyType.

En Visual Studio, el Diseñador de recursos genera automáticamente código que define un internal (en C#) o Friend (en Visual Basic) la clase cuyo nombre es el mismo que el nombre base del archivo .resources para la referencia cultural predeterminada.In Visual Studio, the Resource Designer automatically generates code that defines an internal (in C#) or Friend (in Visual Basic) class whose name is the same as the base name of the .resources file for the default culture. Esto hace posible crear una instancia de un ResourceManager de objetos y asociarlos a un determinado conjunto de recursos mediante la obtención de un objeto de tipo cuyo nombre se corresponde con el nombre del recurso, ya que siempre que la clase sea visible para el compilador, los recursos deben estar como bien.This makes it possible to instantiate a ResourceManager object and couple it with a particular set of resources by getting a type object whose name corresponds to the name of the resource, because as long as the class is visible to the compiler, the resources must be as well. Por ejemplo, si un archivo .resources denominado Resource1, la siguiente instrucción crea una instancia de un ResourceManager objeto para administrar el archivo .resources denominado Resource1:For example, if a .resources file is named Resource1, the following statement instantiates a ResourceManager object to manage the .resources file named Resource1:

ResourceManager rm = new ResourceManager(typeof(Resource1));

Si no usa Visual Studio, puede crear una clase sin miembros cuyo nombre y espacio de nombres son los mismos que el del archivo .resources predeterminado.If you're not using Visual Studio, you can create a class with no members whose namespace and name are the same as that of the default .resources file. En este ejemplo se ilustra.The example provides an illustration.

Aplicaciones de Tienda Windows 8.xWindows 8.x StoreTienda Windows 8.xWindows 8.x Store Apps

Importante

Aunque el ResourceManager clase es compatible en Tienda Windows 8.xWindows 8.x Store las aplicaciones, no se recomienda su uso.Although the ResourceManager class is supported in Tienda Windows 8.xWindows 8.x Store apps, we do not recommend its use. Utilice esta clase solo cuando se desarrollan Biblioteca de clases portablePortable Class Library proyectos que se pueden usar con Tienda Windows 8.xWindows 8.x Store aplicaciones.Use this class only when you develop Biblioteca de clases portablePortable Class Library projects that can be used with Tienda Windows 8.xWindows 8.x Store apps. Para recuperar recursos desde Tienda Windows 8.xWindows 8.x Store aplicaciones, use el Windows.ApplicationModel.Resources.ResourceLoader clase en su lugar.To retrieve resources from Tienda Windows 8.xWindows 8.x Store apps, use the Windows.ApplicationModel.Resources.ResourceLoader class instead.

En Tienda Windows 8.xWindows 8.x Store aplicaciones, ResourceManager usa el resourceSource parámetro para deducir el ensamblado, el nombre base y el espacio de nombres donde los elementos del recurso pueden ubicarse en el archivo de recursos (PRI) de índice del paquete de la aplicación.In Tienda Windows 8.xWindows 8.x Store apps, ResourceManager uses the resourceSource parameter to infer the assembly, base name, and the namespace where the resource items can be located within the app's package resource index (PRI) file. Por ejemplo, dado un tipo denominado MyCompany.MyProduct.MyType que se define en MyAssembly, el Administrador de recursos es para un recurso del conjunto de identificador que se denomine MyAssembly y busca un ámbito MyCompany.MyProduct.MyType dentro de ese conjunto de recursos.For example, given a type named MyCompany.MyProduct.MyType that is defined in MyAssembly, the resource manager looks for a resource set identifier named MyAssembly and looks for a scope MyCompany.MyProduct.MyType within that resource set. Busca en el Administrador de recursos para los elementos de recursos en el contexto predeterminado (referencia cultural actual, la configuración de contraste alto actual etc.) dentro de este ámbito.The resource manager searches for resource items under the default context (current culture, current high contrast setting, and so on) within this scope.

ResourceManager(String, Assembly) ResourceManager(String, Assembly) ResourceManager(String, Assembly)

Inicializa una nueva instancia de la clase ResourceManager que busca los recursos que contienen los archivos con el nombre raíz especificado, en el objeto dado.Initializes a new instance of the ResourceManager class that looks up resources contained in files with the specified root name in the given assembly.

public:
 ResourceManager(System::String ^ baseName, System::Reflection::Assembly ^ assembly);
public ResourceManager (string baseName, System.Reflection.Assembly assembly);
new System.Resources.ResourceManager : string * System.Reflection.Assembly -> System.Resources.ResourceManager

Parámetros

baseName
String String String String

Nombre de raíz del archivo de recursos sin su extensión pero con cualquier nombre de espacio de nombres completo.The root name of the resource file without its extension but including any fully qualified namespace name. Por ejemplo, el nombre de raíz para el archivo de recursos denominado "MyApplication.MyResource.en-US.resources" es "MyApplication.MyResource".For example, the root name for the resource file named MyApplication.MyResource.en-US.resources is MyApplication.MyResource.

assembly
Assembly Assembly Assembly Assembly

Ensamblado principal de los recursos.The main assembly for the resources.

Excepciones

El parámetro baseName o assembly es null.The baseName or assembly parameter is null.

Ejemplos

En el ejemplo siguiente se usa una aplicación de "Hello World" sencilla no localizado para ilustrar la ResourceManager(String, Assembly) constructor.The following example uses a simple non-localized "Hello World" app to illustrate the ResourceManager(String, Assembly) constructor. La siguiente muestra el contenido de un archivo de texto denominado ExampleResources.txt.The following shows the contents of a text file named ExampleResources.txt. Cuando se compila la aplicación, el recurso se incrusta en el ensamblado de aplicación principal.When the app is compiled, the resource is embedded in the main app assembly.

Greeting=Hello  

El archivo de texto se puede convertir en un archivo de recursos binario mediante el uso de la en el comando de símbolo del sistema como sigue:The text file can be converted to a binary resource file by using the at the command prompt as follows:

resgen ExampleResources.txt  

En el ejemplo siguiente se proporciona el código ejecutable que se crea una instancia de un ResourceManager pide al usuario que escriba un nombre de objeto y mostrará un saludo.The following example provides the executable code that instantiates a ResourceManager object, prompts the user to enter a name, and displays a greeting.

using System;
using System.Reflection;
using System.Resources;

public class Example
{
   public static void Main()
   {
      // Retrieve the resource.
      ResourceManager rm = new ResourceManager("ExampleResources" , 
                               typeof(Example).Assembly);
      string greeting = rm.GetString("Greeting");
      
      Console.Write("Enter your name: ");
      string name = Console.ReadLine();
      Console.WriteLine("{0} {1}!", greeting, name);
   }
}
// The example produces output similar to the following:
//       Enter your name: John
//       Hello John!
Imports System.Globalization
Imports System.Reflection
Imports System.Resources

Module Example
   Public Sub Main()
      ' Retrieve the resource.
      Dim rm As New ResourceManager("ExampleResources", 
                                    GetType(Example).Assembly)
      Dim greeting As String = rm.GetString("Greeting")
      
      Console.Write("Enter your name: ")
      Dim name As String = Console.ReadLine()
      Console.WriteLine("{0} {1}!", greeting, name)
   End Sub
End Module
' The example produces output similar to the following:
'       Enter your name: John
'       Hello John!

Se puede compilar mediante el comando siguiente en Visual Basic:It can be compiled by using the following command in Visual Basic:

vbc Example.vb /resource:ExampleResources.resources  

o bien, mediante el siguiente comando en C#:or by using the following command in C#:

csc Example.cs /resource:ExampleResources.resources  

Tenga en cuenta que el ejemplo recupera una referencia al ensamblado que contiene el archivo de recursos al pasar un tipo definido en dicho ensamblado para el typeof función (en C#) o el GetType función (en Visual Basic) y recuperar el valor de su Type.Assemblypropiedad.Note that the example retrieves a reference to the assembly that contains the resource file by passing a type defined in that assembly to the typeof function (in C#) or the GetType function (in Visual Basic) and retrieving the value of its Type.Assembly property.

Comentarios

Aplicaciones de escritorioDesktop Apps

En las aplicaciones de escritorio, los archivos de recursos individuales de referencia cultural específica deben estar incluidos en los ensamblados satélite y archivo de recursos de la referencia cultural de forma predeterminada debe estar incluido en el ensamblado principal.In desktop apps, the individual culture-specific resource files should be contained in satellite assemblies, and the default culture's resource file should be contained in the main assembly. Un ensamblado satélite se supone que contiene los recursos de una única referencia cultural especificada en el manifiesto del ensamblado y se carga según sea necesario.A satellite assembly is assumed to contain resources for a single culture specified in that assembly's manifest, and is loaded as necessary.

Nota

Para recuperar recursos desde archivos .resources directamente en lugar de recuperarlos desde ensamblados, debe llamar a la CreateFileBasedResourceManager método en su lugar para crear instancias de un ResourceManager objeto.To retrieve resources from .resources files directly instead of retrieving them from assemblies, you must call the CreateFileBasedResourceManager method instead to instantiate a ResourceManager object.

Si el archivo de recursos identificados por baseName no se encuentra en assembly, el método crea una instancia de un ResourceManager objeto, pero el intento de recuperar un recurso concreto produce una excepción, normalmente MissingManifestResourceException.If the resource file identified by baseName cannot be found in assembly, the method instantiates a ResourceManager object, but the attempt to retrieve a specific resource throws an exception, typically MissingManifestResourceException. Para obtener información acerca de cómo diagnosticar la causa de la excepción, vea la sección "Control the MissingManifestResourceException (excepción)" de la ResourceManager tema de la clase.For information about diagnosing the cause of the exception, see the "Handling the MissingManifestResourceException Exception" section of the ResourceManager class topic.

Aplicaciones de Tienda Windows 8.xWindows 8.x StoreTienda Windows 8.xWindows 8.x Store Apps

Importante

Aunque el ResourceManager clase es compatible en Tienda Windows 8.xWindows 8.x Store las aplicaciones, no se recomienda su uso.Although the ResourceManager class is supported in Tienda Windows 8.xWindows 8.x Store apps, we do not recommend its use. Utilice esta clase solo cuando se desarrollan Biblioteca de clases portablePortable Class Library proyectos que se pueden usar con Tienda Windows 8.xWindows 8.x Store aplicaciones.Use this class only when you develop Biblioteca de clases portablePortable Class Library projects that can be used with Tienda Windows 8.xWindows 8.x Store apps. Para recuperar recursos desde Tienda Windows 8.xWindows 8.x Store aplicaciones, use el Windows.ApplicationModel.Resources.ResourceLoader clase en su lugar.To retrieve resources from Tienda Windows 8.xWindows 8.x Store apps, use the Windows.ApplicationModel.Resources.ResourceLoader class instead.

En Tienda Windows 8.xWindows 8.x Store apps, el Administrador de recursos usa el nombre sencillo de la assembly establecido para buscar un recurso coincidente en el archivo de recursos (PRI) de índice del paquete de la aplicación.In Tienda Windows 8.xWindows 8.x Store apps, the resource manager uses the simple name of the assembly parameter to look up a matching resource set in the app's package resource index (PRI) file. El baseName parámetro se usa para buscar un elemento de recurso en el conjunto de recursos.The baseName parameter is used to look up a resource item within the resource set. Por ejemplo, el nombre de raíz para PortableLibrary1.Resource1.de-DE.resources es PortableLibrary1.Resource1.For example, the root name for PortableLibrary1.Resource1.de-DE.resources is PortableLibrary1.Resource1.

Notas a los desarrolladores de herederos

Este constructor utiliza proporcionado por el sistema ResourceSet implementación.This constructor uses the system-provided ResourceSet implementation. Para usar un formato de archivo de recursos personalizado, debe derivar de la ResourceSet clase, invalide el GetDefaultReader() y GetDefaultWriter() métodos y pase que escriba para la ResourceManager(String, Assembly, Type) constructor.To use a custom resource file format, you should derive from the ResourceSet class, override the GetDefaultReader() and GetDefaultWriter() methods, and pass that type to the ResourceManager(String, Assembly, Type) constructor. Utiliza una ResourceSet puede ser útil para controlar recurso de la directiva de caché o que admiten el formato de archivo de recursos, pero generalmente no es necesario.Using a custom ResourceSet can be useful for controlling resource caching policy or supporting your own resource file format, but is generally not necessary.

ResourceManager(String, Assembly, Type) ResourceManager(String, Assembly, Type) ResourceManager(String, Assembly, Type)

Inicializa una nueva instancia de la clase ResourceManager que usa un ResourceSet especificado para buscar recursos que contenga archivos con el nombre de raíz especificado en el ensamblado determinado.Initializes a new instance of the ResourceManager class that uses a specified ResourceSet class to look up resources contained in files with the specified root name in the given assembly.

public:
 ResourceManager(System::String ^ baseName, System::Reflection::Assembly ^ assembly, Type ^ usingResourceSet);
public ResourceManager (string baseName, System.Reflection.Assembly assembly, Type usingResourceSet);
new System.Resources.ResourceManager : string * System.Reflection.Assembly * Type -> System.Resources.ResourceManager

Parámetros

baseName
String String String String

Nombre de raíz del archivo de recursos sin su extensión pero con cualquier nombre de espacio de nombres completo.The root name of the resource file without its extension but including any fully qualified namespace name. Por ejemplo, el nombre de raíz para el archivo de recursos denominado "MyApplication.MyResource.en-US.resources" es "MyApplication.MyResource".For example, the root name for the resource file named MyApplication.MyResource.en-US.resources is MyApplication.MyResource.

assembly
Assembly Assembly Assembly Assembly

Ensamblado principal de los recursos.The main assembly for the resources.

usingResourceSet
Type Type Type Type

Tipo del objeto ResourceSet personalizado que se va a usar.The type of the custom ResourceSet to use. Si es null, se usa el objeto predeterminado ResourceSet en tiempo de ejecución.If null, the default runtime ResourceSet object is used.

Excepciones

usingResourceset no se deriva de ResourceSet.usingResourceset is not a derived class of ResourceSet.

El parámetro baseName o assembly es null.The baseName or assembly parameter is null.

Comentarios

Los archivos de recursos individuales de referencia cultural específica deben estar incluidos en los ensamblados satélite y archivo de recursos de la referencia cultural de forma predeterminada debe estar incluido en el ensamblado principal.The individual culture-specific resource files should be contained in satellite assemblies, and the default culture's resource file should be contained in the main assembly. Un ensamblado satélite se supone que contiene los recursos de una única referencia cultural especificada en el manifiesto del ensamblado y se carga según sea necesario.A satellite assembly is assumed to contain resources for a single culture specified in that assembly's manifest, and is loaded as necessary.

Nota

Para recuperar recursos desde archivos .resources directamente en lugar de recuperarlos desde ensamblados, debe llamar a la CreateFileBasedResourceManager método en su lugar para crear instancias de un ResourceManager objeto.To retrieve resources from .resources files directly instead of retrieving them from assemblies, you must call the CreateFileBasedResourceManager method instead to instantiate a ResourceManager object.

Si el archivo de recursos identificados por baseName no se encuentra en assembly, el método crea una instancia de un ResourceManager objeto, pero el intento de recuperar un recurso concreto produce una excepción, normalmente MissingManifestResourceException.If the resource file identified by baseName cannot be found in assembly, the method instantiates a ResourceManager object, but the attempt to retrieve a specific resource throws an exception, typically MissingManifestResourceException. Para obtener información acerca de cómo diagnosticar la causa de la excepción, vea la sección "Control the MissingManifestResourceException (excepción)" de la ResourceManager tema de la clase.For information about diagnosing the cause of the exception, see the "Handling the MissingManifestResourceException Exception" section of the ResourceManager class topic.

Nota

El usingResourceSet parámetro se usa para admitir el formato de recursos y, normalmente será null.The usingResourceSet parameter is used to support your own resource format, and will commonly be null. Esto es diferente del constructor que toma un Type solo.This is different from the constructor that takes a Type only.

Notas a los autores de las llamadas

Este constructor permite especificar un ResourceSet implementación.This constructor lets you specify a ResourceSet implementation. Si no desea que un determinado ResourceSet implementación pero desea utilizar un formato de archivo de recursos personalizado, debe derivar de la ResourceSet clase, invalide el GetDefaultReader() y GetDefaultWriter() métodos y que escriba pase a este constructor.If you do not want a specific ResourceSet implementation but would like to use a custom resource file format, you should derive from the ResourceSet class, override the GetDefaultReader() and GetDefaultWriter() methods, and pass that type to this constructor.

Se aplica a