ResourceManager Construtores

Definição

Inicializa uma nova instância da classe ResourceManager.Initializes a new instance of the ResourceManager class.

Sobrecargas

ResourceManager()

Inicializa uma nova instância da classe ResourceManager sem os valores padrão.Initializes a new instance of the ResourceManager class with default values.

ResourceManager(Type)

Inicializa uma nova instância da classe ResourceManager que procura recursos em assemblies satélites com base nas informações do objeto do 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)

Inicializa uma nova instância da classe ResourceManager que pesquisa os recursos contidos em arquivos com o nome raiz especificado no assembly especificado.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)

Inicializa uma nova instância da classe ResourceManager que usa um classe ResourceSet especificada para pesquisar os recursos contidos em arquivos com o nome raiz especificado no assembly fornecido.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()

Inicializa uma nova instância da classe ResourceManager sem os valores padrão.Initializes a new instance of the ResourceManager class with default values.

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

Comentários

Esse construtor é útil apenas se você escrever sua própria classe que deriva da classe ResourceManager.This constructor is useful only if you write your own class that derives from the ResourceManager class.

ResourceManager(Type)

Inicializa uma nova instância da classe ResourceManager que procura recursos em assemblies satélites com base nas informações do objeto do 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

Um tipo do qual o gerenciador de recursos deriva todas as informações para localizar arquivos .resources.A type from which the resource manager derives all information for finding .resources files.

Exceções

O parâmetro resourceSource é null.The resourceSource parameter is null.

Exemplos

O exemplo a seguir usa o Construtor ResourceManager(Type) para instanciar um objeto ResourceManager.The following example uses the ResourceManager(Type) constructor to instantiate a ResourceManager object. Ele consiste em recursos compilados de arquivos. txt para as culturas inglês (EN), francês (França) (fr-FR) e russo (Rússia) (RU-RU).It consists of resources compiled from .txt files for the English (en), French (France) (fr-FR), and Russian (Russia) (ru-RU) cultures. O exemplo altera a cultura atual e a cultura da interface do usuário atual para inglês (Estados Unidos), francês (França), russo (Rússia) e Sueco (Suécia).The example changes the current culture and current UI culture to English (United States), French (France), Russian (Russia), and Swedish (Sweden). Em seguida, ele chama o método GetString(String) para recuperar a cadeia de caracteres localizada, que exibe uma saudação que depende da hora do dia.It then calls the GetString(String) method to retrieve the localized string, which displays a greeting that depends on the time of day.

O exemplo requer três arquivos de recurso baseados em texto, conforme listado na tabela a seguir.The example requires three text-based resource files, as listed in the following table. Cada arquivo inclui recursos de cadeia de caracteres chamados Morning, Afternoone Evening.Each file includes string resources named Morning, Afternoon, and Evening.

CulturaCulture Nome do arquivoFile name Nome do recursoResource name Valor do recursoResource value
en-USen-US GreetingResources.txtGreetingResources.txt Morning Bom diaGood morning
en-USen-US GreetingResources.txtGreetingResources.txt Afternoon Boa tardeGood afternoon
en-USen-US GreetingResources.txtGreetingResources.txt Evening Boa noiteGood 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 Добрый вечерДобрый вечер

Você pode usar o arquivo em lotes a seguir para compilar o exemplo de Visual Basic e criar um executável chamado Greet. exe.You can use the following batch file to compile the Visual Basic example and create an executable named Greet.exe. Para compilar com C#o, altere o nome do compilador de vbc para csc e a extensão de arquivo de .vb para .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 é o código-fonte do exemplo (exdate. vb para a versão Visual Basic ou ShowDate.cs para a C# versão do 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!

Além de definir uma classe de aplicativo chamada Example, o código-fonte define uma classe interna cujo nome, GreetingResources, é o mesmo que o nome base dos arquivos 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. Isso possibilita instanciar com êxito um objeto ResourceManager chamando o Construtor ResourceManager(Type).This makes it possible to successfully instantiate a ResourceManager object by calling the ResourceManager(Type) constructor.

Observe que a saída exibe a cadeia de caracteres localizada apropriada, exceto quando a cultura da interface do usuário atual é sueco (Suécia); nesse caso, ela usa recursos de idioma do 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. Como os recursos de idioma sueco não estão disponíveis, o aplicativo usa os recursos da cultura padrão, conforme definido pelo atributo NeutralResourcesLanguageAttribute, em vez disso.Because Swedish language resources are unavailable, the app uses the resources of the default culture, as defined by the NeutralResourcesLanguageAttribute attribute, instead.

Comentários

Aplicativos de área de trabalhoDesktop Apps

Em aplicativos da área de trabalho, o Gerenciador de recursos usa o parâmetro resourceSource para carregar um arquivo de recurso específico da seguinte maneira:In desktop apps, the resource manager uses the resourceSource parameter to load a particular resource file as follows:

  • Se o atributo NeutralResourcesLanguageAttribute não for usado para indicar que os recursos da cultura padrão residem em um assembly satélite, o Gerenciador de recursos assumirá que o arquivo de recurso para a cultura padrão é encontrado no mesmo assembly que o tipo especificado pelo parâmetro resourceSource.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.

  • O Gerenciador de recursos assume que o arquivo de recurso padrão tem o mesmo nome base que o tipo especificado pelo parâmetro resourceSource.The resource manager assumes that the default resource file has the same base name as the type specified by the resourceSource parameter.

  • O Gerenciador de recursos usa a classe de ResourceSet padrão para manipular o arquivo de recurso.The resource manager uses the default ResourceSet class to manipulate the resource file.

Por exemplo, dado um tipo chamado MyCompany. MyProduct. com MyType, o Gerenciador de recursos procura um arquivo. Resources chamado MyCompany. MyProduct. com MyType. Resources no assembly que define com 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.

No Visual Studio, o designer de recursos gera automaticamente um código que define uma classe C#internal (in) ou Friend (na Visual Basic) cujo nome é o mesmo que o nome base do arquivo. Resources para a cultura padrão.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. Isso torna possível criar uma instância de um objeto ResourceManager e acopla-lo a um determinado conjunto de recursos, obtendo um objeto de tipo cujo nome corresponde ao nome do recurso, porque, desde que a classe esteja visível para o compilador, os recursos também devem ser.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 exemplo, se um arquivo. Resources for nomeado Recurso1, a instrução a seguir instanciará um objeto ResourceManager para gerenciar o arquivo. Resources chamado Recurso1: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));

Se você não estiver usando o Visual Studio, poderá criar uma classe sem membros cujo namespace e o nome sejam iguais aos do arquivo default. Resources.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. O exemplo fornece uma ilustração.The example provides an illustration.

Aplicativos do Windows Store 8.xWindows 8.x StoreWindows Store 8.xWindows 8.x Store Apps

Importante

Embora a classe ResourceManager tenha suporte em aplicativos Windows Store 8.xWindows 8.x Store, não recomendamos seu uso.Although the ResourceManager class is supported in Windows Store 8.xWindows 8.x Store apps, we do not recommend its use. Use essa classe somente quando desenvolver Biblioteca de Classes PortátilPortable Class Library projetos que possam ser usados com Windows Store 8.xWindows 8.x Store aplicativos.Use this class only when you develop Biblioteca de Classes PortátilPortable Class Library projects that can be used with Windows Store 8.xWindows 8.x Store apps. Para recuperar recursos de aplicativos Windows Store 8.xWindows 8.x Store, use a classe Windows. ApplicationModel. Resources. ResourceLoader em vez disso.To retrieve resources from Windows Store 8.xWindows 8.x Store apps, use the Windows.ApplicationModel.Resources.ResourceLoader class instead.

Em Windows Store 8.xWindows 8.x Store aplicativos, ResourceManager usa o parâmetro resourceSource para inferir o assembly, o nome base e o namespace em que os itens de recurso podem ser localizados no arquivo PRI (índice de recursos de pacote) do aplicativo.In Windows Store 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 exemplo, dado um tipo chamado MyCompany. MyProduct. com MyType que é definido em MyAssembly, o Gerenciador de recursos procura um identificador de conjunto de recursos chamado MyAssembly e procura um escopo MyCompany. MyProduct. com MyType nesse 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. O Gerenciador de recursos procura itens de recurso no contexto padrão (cultura atual, configuração de alto contraste atual e assim por diante) nesse escopo.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)

Inicializa uma nova instância da classe ResourceManager que pesquisa os recursos contidos em arquivos com o nome raiz especificado no assembly especificado.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

O nome raiz do arquivo de recurso sem sua extensão, mas incluindo um nome de namespace totalmente qualificado.The root name of the resource file without its extension but including any fully qualified namespace name. Por exemplo, o nome raiz do arquivo de recurso chamado MyApplication.MyResource.en-us.resources é MyApplication.MyResource.For example, the root name for the resource file named MyApplication.MyResource.en-US.resources is MyApplication.MyResource.

assembly
Assembly

O assembly principal dos recursos.The main assembly for the resources.

Exceções

O parâmetro baseName ou assembly é null.The baseName or assembly parameter is null.

Exemplos

O exemplo a seguir usa um aplicativo "Olá, Mundo" não localizado simples para ilustrar o construtor de ResourceManager(String, Assembly).The following example uses a simple non-localized "Hello World" app to illustrate the ResourceManager(String, Assembly) constructor. O seguinte mostra o conteúdo de um arquivo de texto chamado ExampleResources. txt.The following shows the contents of a text file named ExampleResources.txt. Quando o aplicativo é compilado, o recurso é inserido no assembly do aplicativo principal.When the app is compiled, the resource is embedded in the main app assembly.

Greeting=Hello  

O arquivo de texto pode ser convertido em um arquivo de recurso binário usando o gerador de arquivo de recurso (Resgen. exe) no prompt de comando da seguinte maneira:The text file can be converted to a binary resource file by using the Resource File Generator (ResGen.exe) at the command prompt as follows:

resgen ExampleResources.txt  

O exemplo a seguir fornece o código executável que instancia um objeto ResourceManager, solicita que o usuário insira um nome e exibe uma saudação.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!

Ele pode ser compilado usando o seguinte comando no Visual Basic:It can be compiled by using the following command in Visual Basic:

vbc Example.vb /resource:ExampleResources.resources  

ou usando o seguinte comando no C#:or by using the following command in C#:

csc Example.cs /resource:ExampleResources.resources  

Observe que o exemplo recupera uma referência ao assembly que contém o arquivo de recurso, passando um tipo definido no assembly para a função typeof (in C#) ou a função GetType (em Visual Basic) e recuperando o valor de sua propriedade Type.Assembly.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.

Comentários

Aplicativos de área de trabalhoDesktop Apps

Em aplicativos de área de trabalho, os arquivos de recurso específicos de cultura individuais devem estar contidos em assemblies satélites, e o arquivo de recurso da cultura padrão deve estar contido no assembly 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. Um assembly satélite é considerado para conter recursos para uma única cultura especificada no manifesto do assembly e é carregado conforme necessário.A satellite assembly is assumed to contain resources for a single culture specified in that assembly's manifest, and is loaded as necessary.

Observação

Para recuperar recursos de arquivos. Resources diretamente em vez de recuperá-los de assemblies, você deve chamar o método CreateFileBasedResourceManager em vez de criar uma instância de um objeto ResourceManager.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.

Se o arquivo de recurso identificado por baseName não puder ser encontrado em assembly, o método instanciará um objeto ResourceManager, mas a tentativa de recuperar um recurso específico lançará uma exceção, geralmente 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 obter informações sobre como diagnosticar a causa da exceção, consulte a seção "manipulando a exceção MissingManifestResourceException" do tópico ResourceManager classe.For information about diagnosing the cause of the exception, see the "Handling the MissingManifestResourceException Exception" section of the ResourceManager class topic.

Aplicativos do Windows Store 8.xWindows 8.x StoreWindows Store 8.xWindows 8.x Store Apps

Importante

Embora a classe ResourceManager tenha suporte em aplicativos Windows Store 8.xWindows 8.x Store, não recomendamos seu uso.Although the ResourceManager class is supported in Windows Store 8.xWindows 8.x Store apps, we do not recommend its use. Use essa classe somente quando desenvolver Biblioteca de Classes PortátilPortable Class Library projetos que possam ser usados com Windows Store 8.xWindows 8.x Store aplicativos.Use this class only when you develop Biblioteca de Classes PortátilPortable Class Library projects that can be used with Windows Store 8.xWindows 8.x Store apps. Para recuperar recursos de aplicativos Windows Store 8.xWindows 8.x Store, use a classe Windows. ApplicationModel. Resources. ResourceLoader em vez disso.To retrieve resources from Windows Store 8.xWindows 8.x Store apps, use the Windows.ApplicationModel.Resources.ResourceLoader class instead.

Em aplicativos Windows Store 8.xWindows 8.x Store, o Gerenciador de recursos usa o nome simples do parâmetro assembly para pesquisar um conjunto de recursos correspondentes no arquivo de índice de recursos do pacote (PRI) do aplicativo.In Windows Store 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. O parâmetro baseName é usado para pesquisar um item de recurso no conjunto de recursos.The baseName parameter is used to look up a resource item within the resource set. Por exemplo, o nome raiz para PortableLibrary1.Resource1.de-DE. Resources é PortableLibrary1. Recurso1.For example, the root name for PortableLibrary1.Resource1.de-DE.resources is PortableLibrary1.Resource1.

Notas aos Herdeiros

Esse construtor usa a implementação de ResourceSet fornecida pelo sistema.This constructor uses the system-provided ResourceSet implementation. Para usar um formato de arquivo de recurso personalizado, você deve derivar da classe ResourceSet, substituir os métodos GetDefaultReader() e GetDefaultWriter() e passar esse tipo para o construtor de ResourceManager(String, Assembly, Type).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. Usar um ResourceSet personalizado pode ser útil para controlar a política de cache de recursos ou dar suporte ao seu próprio formato de arquivo de recurso, mas geralmente não é necessário.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)

Inicializa uma nova instância da classe ResourceManager que usa um classe ResourceSet especificada para pesquisar os recursos contidos em arquivos com o nome raiz especificado no assembly fornecido.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

O nome raiz do arquivo de recurso sem sua extensão, mas incluindo um nome de namespace totalmente qualificado.The root name of the resource file without its extension but including any fully qualified namespace name. Por exemplo, o nome raiz do arquivo de recurso chamado MyApplication.MyResource.en-us.resources é MyApplication.MyResource.For example, the root name for the resource file named MyApplication.MyResource.en-US.resources is MyApplication.MyResource.

assembly
Assembly

O assembly principal dos recursos.The main assembly for the resources.

usingResourceSet
Type

O tipo do ResourceSet personalizado a ser usado.The type of the custom ResourceSet to use. Se null, o objeto ResourceSet do runtime padrão será usado.If null, the default runtime ResourceSet object is used.

Exceções

usingResourceset não é uma classe derivada de ResourceSet.usingResourceset is not a derived class of ResourceSet.

O parâmetro baseName ou assembly é null.The baseName or assembly parameter is null.

Comentários

Os arquivos de recurso específicos de cultura individuais devem estar contidos em assemblies satélites, e o arquivo de recurso da cultura padrão deve estar contido no assembly 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. Um assembly satélite é considerado para conter recursos para uma única cultura especificada no manifesto do assembly e é carregado conforme necessário.A satellite assembly is assumed to contain resources for a single culture specified in that assembly's manifest, and is loaded as necessary.

Observação

Para recuperar recursos de arquivos. Resources diretamente em vez de recuperá-los de assemblies, você deve chamar o método CreateFileBasedResourceManager em vez de criar uma instância de um objeto ResourceManager.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.

Se o arquivo de recurso identificado por baseName não puder ser encontrado em assembly, o método instanciará um objeto ResourceManager, mas a tentativa de recuperar um recurso específico lançará uma exceção, geralmente 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 obter informações sobre como diagnosticar a causa da exceção, consulte a seção "manipulando a exceção MissingManifestResourceException" do tópico ResourceManager classe.For information about diagnosing the cause of the exception, see the "Handling the MissingManifestResourceException Exception" section of the ResourceManager class topic.

Observação

O parâmetro usingResourceSet é usado para dar suporte ao seu próprio formato de recurso e normalmente será null.The usingResourceSet parameter is used to support your own resource format, and will commonly be null. Isso é diferente do construtor que usa apenas um Type.This is different from the constructor that takes a Type only.

Notas aos Chamadores

Esse construtor permite que você especifique uma implementação de ResourceSet.This constructor lets you specify a ResourceSet implementation. Se você não quiser uma implementação de ResourceSet específica, mas quiser usar um formato de arquivo de recurso personalizado, deverá derivar da classe ResourceSet, substituir os métodos GetDefaultReader() e GetDefaultWriter() e passar esse tipo para esse construtor.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.

Aplica-se a