ResourceManager ResourceManager ResourceManager ResourceManager Constructors

Definizione

Overload

ResourceManager() ResourceManager() ResourceManager()

Inizializza una nuova istanza della classe ResourceManager con i valori predefiniti.Initializes a new instance of the ResourceManager class with default values.

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

Inizializza una nuova istanza della classe ResourceManager che ricerca le risorse negli assembly satellite in base alle informazioni derivate dall'oggetto di tipo specificato.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)

Inizializza una nuova istanza della classe ResourceManager che ricerca le risorse contenute nei file con il nome radice specificato nell'assembly fornito.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)

Inizializza una nuova istanza della classe ResourceManager che usa una classe ResourceSet specificata per cercare le risorse contenute nei file con il nome radice specificato nell'assembly fornito.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()

Inizializza una nuova istanza della classe ResourceManager con i valori predefiniti.Initializes a new instance of the ResourceManager class with default values.

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

Commenti

Questo costruttore è utile solo se si scrive una classe che deriva dal ResourceManager classe.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)

Inizializza una nuova istanza della classe ResourceManager che ricerca le risorse negli assembly satellite in base alle informazioni derivate dall'oggetto di tipo specificato.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)

Parametri

resourceSource
Type Type Type Type

Tipo da cui il gestore delle risorse deriva tutte le informazioni per la ricerca dei file con estensione resources.A type from which the resource manager derives all information for finding .resources files.

Eccezioni

Il valore del parametro resourceSource è null.The resourceSource parameter is null.

Esempi

L'esempio seguente usa il ResourceManager(Type) costruttore per creare un'istanza di un ResourceManager oggetto.The following example uses the ResourceManager(Type) constructor to instantiate a ResourceManager object. È costituito da risorse compilate dal file con estensione txt per l'inglese (en), francesi (Francia) fr-FR () e russe (Russia) (ru-RU) le impostazioni cultura.It consists of resources compiled from .txt files for the English (en), French (France) (fr-FR), and Russian (Russia) (ru-RU) cultures. Nell'esempio viene modificato le impostazioni cultura correnti e impostazioni cultura correnti dell'interfaccia utente per inglese (Stati Uniti), francesi (Francia), russe (Russia) e svedese (Svezia).The example changes the current culture and current UI culture to English (United States), French (France), Russian (Russia), and Swedish (Sweden). Chiama quindi il GetString(String) metodo per recuperare la stringa localizzata, che visualizza un messaggio di saluto che dipende da ora del giorno.It then calls the GetString(String) method to retrieve the localized string, which displays a greeting that depends on the time of day.

L'esempio richiede tre file di risorse basate su testo, come indicato nella tabella seguente.The example requires three text-based resource files, as listed in the following table. Ogni file include risorse stringa denominate Morning, Afternoon, e Evening.Each file includes string resources named Morning, Afternoon, and Evening.

cultureCulture Nome fileFile name Nome della risorsaResource name Valore della risorsaResource value
en-USen-US GreetingResources.txtGreetingResources.txt Morning BuongiornoGood morning
en-USen-US GreetingResources.txtGreetingResources.txt Afternoon Buon pomeriggioGood afternoon
en-USen-US GreetingResources.txtGreetingResources.txt Evening Buona seraGood 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 Добрый вечерДобрый вечер

È possibile utilizzare il seguente file batch per compilare l'esempio di Visual Basic e creare un file eseguibile denominato Greet.exe.You can use the following batch file to compile the Visual Basic example and create an executable named Greet.exe. Per compilare con c#, modificare il nome del compilatore da vbc al csc e l'estensione di file da .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  

Ecco il codice sorgente per l'esempio (ShowDate.vb per la versione Visual Basic) o ShowDate.cs per la versione c# del codice.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!

Oltre a definire una classe app denominata Example, il codice sorgente definisce una classe interna, il cui nome GreetingResources, corrisponde al nome di base del file di risorse.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. Questo rende possibile creare un'istanza di correttamente una ResourceManager chiamando il ResourceManager(Type) costruttore.This makes it possible to successfully instantiate a ResourceManager object by calling the ResourceManager(Type) constructor.

Si noti che l'output visualizza localizzate appropriate in formato stringa tranne quando le impostazioni cultura correnti dell'interfaccia utente sono svedese (Svezia), nel qual caso si usa risorse di lingua inglese.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. Poiché le risorse di lingua svedese sono disponibili, l'app Usa le risorse le impostazioni cultura predefinite, come definito dal NeutralResourcesLanguageAttribute , attributo.Because Swedish language resources are unavailable, the app uses the resources of the default culture, as defined by the NeutralResourcesLanguageAttribute attribute, instead.

Commenti

App desktopDesktop Apps

Nelle App desktop, Gestione risorse Usa i resourceSource parametro per caricare un file di risorse specifico, come indicato di seguito:In desktop apps, the resource manager uses the resourceSource parameter to load a particular resource file as follows:

  • Se il NeutralResourcesLanguageAttribute attributo non viene utilizzato per indicare che le risorse delle impostazioni cultura predefinite si trovano in un assembly satellite, resource manager presuppone che il file di risorse per la lingua predefinita non viene trovato nello stesso assembly del tipo specificato per il resourceSource parametro.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.

  • Resource manager presuppone che il file di risorse predefinito ha lo stesso nome di base del tipo specificato da di resourceSource parametro.The resource manager assumes that the default resource file has the same base name as the type specified by the resourceSource parameter.

  • Resource manager Usa il valore predefinito ResourceSet classe per modificare il file di risorse.The resource manager uses the default ResourceSet class to manipulate the resource file.

Ad esempio, dato un tipo denominato MyCompany.MyProduct.MyType, Cerca il gestore di risorse per un file con estensione resources denominato MyCompany.MyProduct.MyType.resources nell'assembly che definisce 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.

In Visual Studio, la finestra di progettazione risorse genera automaticamente il codice che definisce un internal (in c#) o Friend (in Visual Basic) classe il cui nome è lo stesso come il nome di base del file con estensione resources per le impostazioni cultura predefinite.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. Questo rende possibile creare un'istanza di un ResourceManager dell'oggetto e associarlo con un particolare set di risorse tramite il recupero di un oggetto di tipo il cui nome corrisponde al nome della risorsa, in quanto, purché la classe è visibile al compilatore, le risorse devono essere come bene.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. Ad esempio, se un file con estensione resources denominato risorsa 1, l'istruzione seguente crea un'istanza di un ResourceManager oggetto per gestire il file con estensione resources denominato risorsa 1: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 non si usa Visual Studio, è possibile creare una classe senza membri il cui spazio dei nomi e il nome è uguale a quello del file. Resources predefinito.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. Nell'esempio viene illustrata una situazione di questo tipo.The example provides an illustration.

Applicazioni Windows 8.x StoreWindows 8.x StoreWindows 8.x StoreWindows 8.x Store Apps

Importante

Anche se il ResourceManager classe è supportata in Windows 8.x StoreWindows 8.x Store le app, si sconsiglia l'uso.Although the ResourceManager class is supported in Windows 8.x StoreWindows 8.x Store apps, we do not recommend its use. Utilizzare questa classe solo quando si sviluppano Libreria di classi portabilePortable Class Library i progetti che possono essere usati con Windows 8.x StoreWindows 8.x Store app.Use this class only when you develop Libreria di classi portabilePortable Class Library projects that can be used with Windows 8.x StoreWindows 8.x Store apps. Per recuperare le risorse dal Windows 8.x StoreWindows 8.x Store le app, usare il Windows.ApplicationModel.Resources.ResourceLoader classe.To retrieve resources from Windows 8.x StoreWindows 8.x Store apps, use the Windows.ApplicationModel.Resources.ResourceLoader class instead.

In Windows 8.x StoreWindows 8.x Store le app ResourceManager Usa il resourceSource parametro dedurre l'assembly, nome di base e lo spazio dei nomi in cui gli elementi delle risorse possono trovarsi all'interno di file indice (PRI) risorse del pacchetto dell'app.In Windows 8.x StoreWindows 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. Ad esempio, dato un tipo denominato MyCompany.MyProduct.MyType definito in MyAssembly, Gestione risorse di Azure Cerca un set di risorse identificatore denominata MyAssembly e cerca un ambito MyCompany.MyProduct.MyType all'interno di tale set di risorse.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. Resource manager Cerca elementi di risorsa nel contesto predefinito (impostazioni cultura correnti, impostazione di contrasto elevato corrente e così via) all'interno di questo ambito.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)

Inizializza una nuova istanza della classe ResourceManager che ricerca le risorse contenute nei file con il nome radice specificato nell'assembly fornito.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

Parametri

baseName
String String String String

Il nome radice del file di risorse senza l'estensione, ma con un nome completo dello spazio dei nomi.The root name of the resource file without its extension but including any fully qualified namespace name. Il nome radice per il file di risorse denominato "MyApplication.MyResource.en-US.resources" è ad esempio "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

Assembly principale per le risorse.The main assembly for the resources.

Eccezioni

Il parametro baseName o il parametro assembly è null.The baseName or assembly parameter is null.

Esempi

L'esempio seguente usa una semplice app "Hello World" localizzato per illustrare il ResourceManager(String, Assembly) costruttore.The following example uses a simple non-localized "Hello World" app to illustrate the ResourceManager(String, Assembly) constructor. Di seguito viene illustrato il contenuto di un file di testo denominato ExampleResources.The following shows the contents of a text file named ExampleResources.txt. Quando viene compilata l'app, la risorsa è incorporata nell'assembly dell'app principale.When the app is compiled, the resource is embedded in the main app assembly.

Greeting=Hello  

Il file di testo può essere convertito in un file di risorse binario con il Resource File Generator ResGen.exe con il comando richiesto nel modo seguente: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  

Nell'esempio seguente fornisce il codice eseguibile che crea un'istanza di un ResourceManager chiede all'utente di immettere un nome di oggetto e viene visualizzato un messaggio di saluto.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!

Può essere compilato usando il comando seguente in Visual Basic:It can be compiled by using the following command in Visual Basic:

vbc Example.vb /resource:ExampleResources.resources  

In alternativa, con il seguente comando nel linguaggio c#:or by using the following command in C#:

csc Example.cs /resource:ExampleResources.resources  

Si noti che l'esempio recupera un riferimento all'assembly che contiene il file di risorse mediante il passaggio di un tipo definito in tale assembly per il typeof funzione (in c#) o GetType funzione (in Visual Basic) e il recupero del valore del relativo Type.Assemblyproprietà.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.

Commenti

App desktopDesktop Apps

Nelle App desktop, i file di risorse specifiche delle impostazioni cultura singoli devono essere contenuti in assembly satellite e file di risorse di impostazioni cultura predefinite deve essere contenuto nell'assembly principale.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 assembly satellite si presuppone che contenga le risorse per singole impostazioni cultura specificati nel manifesto dell'assembly e viene caricato in base alle esigenze.A satellite assembly is assumed to contain resources for a single culture specified in that assembly's manifest, and is loaded as necessary.

Nota

Per recuperare le risorse dai file con estensione resources direttamente anziché recuperandoli dall'assembly, è necessario chiamare il CreateFileBasedResourceManager metodo invece creare un'istanza di un ResourceManager oggetto.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 il file di risorse identificato da baseName non è stata trovata nel assembly, il metodo crea un'istanza di un ResourceManager oggetto, ma il tentativo di recuperare una risorsa specifica genera un'eccezione, in genere 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. Per informazioni su come diagnosticare la causa dell'eccezione, vedere la sezione "Gestione di MissingManifestResourceException (eccezione)" del ResourceManager argomento relativo alla classe.For information about diagnosing the cause of the exception, see the "Handling the MissingManifestResourceException Exception" section of the ResourceManager class topic.

Applicazioni Windows 8.x StoreWindows 8.x StoreWindows 8.x StoreWindows 8.x Store Apps

Importante

Anche se il ResourceManager classe è supportata in Windows 8.x StoreWindows 8.x Store le app, si sconsiglia l'uso.Although the ResourceManager class is supported in Windows 8.x StoreWindows 8.x Store apps, we do not recommend its use. Utilizzare questa classe solo quando si sviluppano Libreria di classi portabilePortable Class Library i progetti che possono essere usati con Windows 8.x StoreWindows 8.x Store app.Use this class only when you develop Libreria di classi portabilePortable Class Library projects that can be used with Windows 8.x StoreWindows 8.x Store apps. Per recuperare le risorse dal Windows 8.x StoreWindows 8.x Store le app, usare il Windows.ApplicationModel.Resources.ResourceLoader classe.To retrieve resources from Windows 8.x StoreWindows 8.x Store apps, use the Windows.ApplicationModel.Resources.ResourceLoader class instead.

Nelle Windows 8.x StoreWindows 8.x Store le app, resource manager Usa il nome semplice del assembly parametro per cercare una corrispondenza risorsa impostato nel file di indice (PRI) risorse dell'app.In Windows 8.x StoreWindows 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. Il baseName parametro viene usato per cercare un elemento di risorsa all'interno del set di risorse.The baseName parameter is used to look up a resource item within the resource set. Ad esempio, il nome radice per PortableLibrary1.Resource1.de-. Resources è PortableLibrary1.Resource1.For example, the root name for PortableLibrary1.Resource1.de-DE.resources is PortableLibrary1.Resource1.

Note per gli eredi

Questo costruttore utilizza fornito dal sistema ResourceSet implementazione.This constructor uses the system-provided ResourceSet implementation. Per usare un formato di file di risorse personalizzato, è necessario derivare il ResourceSet classe, eseguire l'override di GetDefaultReader() e GetDefaultWriter() metodi e passare il tipo del ResourceManager(String, Assembly, Type) costruttore.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. Usando un oggetto personalizzato ResourceSet può essere utile per il controllo risorsa criteri di memorizzazione nella cache o che supportano il proprio formato di file di risorse, ma in genere non è necessario.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)

Inizializza una nuova istanza della classe ResourceManager che usa una classe ResourceSet specificata per cercare le risorse contenute nei file con il nome radice specificato nell'assembly fornito.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

Parametri

baseName
String String String String

Il nome radice del file di risorse senza l'estensione, ma con un nome completo dello spazio dei nomi.The root name of the resource file without its extension but including any fully qualified namespace name. Il nome radice per il file di risorse denominato "MyApplication.MyResource.en-US.resources" è ad esempio "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

Assembly principale per le risorse.The main assembly for the resources.

usingResourceSet
Type Type Type Type

Tipo dell'oggetto ResourceSet personalizzato da usare.The type of the custom ResourceSet to use. Se è null, viene usato l'oggetto ResourceSet di runtime predefinito.If null, the default runtime ResourceSet object is used.

Eccezioni

usingResourceset non è una classe derivata di ResourceSet.usingResourceset is not a derived class of ResourceSet.

Il parametro baseName o il parametro assembly è null.The baseName or assembly parameter is null.

Commenti

I file di risorse specifiche delle impostazioni cultura singoli devono essere contenuti in assembly satellite e file di risorse di impostazioni cultura predefinite deve essere contenuto nell'assembly principale.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 assembly satellite si presuppone che contenga le risorse per singole impostazioni cultura specificati nel manifesto dell'assembly e viene caricato in base alle esigenze.A satellite assembly is assumed to contain resources for a single culture specified in that assembly's manifest, and is loaded as necessary.

Nota

Per recuperare le risorse dai file con estensione resources direttamente anziché recuperandoli dall'assembly, è necessario chiamare il CreateFileBasedResourceManager metodo invece creare un'istanza di un ResourceManager oggetto.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 il file di risorse identificato da baseName non è stata trovata nel assembly, il metodo crea un'istanza di un ResourceManager oggetto, ma il tentativo di recuperare una risorsa specifica genera un'eccezione, in genere 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. Per informazioni su come diagnosticare la causa dell'eccezione, vedere la sezione "Gestione di MissingManifestResourceException (eccezione)" del ResourceManager argomento relativo alla classe.For information about diagnosing the cause of the exception, see the "Handling the MissingManifestResourceException Exception" section of the ResourceManager class topic.

Nota

Il usingResourceSet parametro viene usato per supportare il proprio formato di risorsa e generalmente è null.The usingResourceSet parameter is used to support your own resource format, and will commonly be null. Questo comportamento è diverso dal costruttore che accetta un Type solo.This is different from the constructor that takes a Type only.

Note per i chiamanti

Questo costruttore consente di specificare un ResourceSet implementazione.This constructor lets you specify a ResourceSet implementation. Se non si desidera uno specifico ResourceSet implementazione ma si desidera utilizzare un formato di file di risorse personalizzato, è necessario derivare il ResourceSet classe, eseguire l'override la GetDefaultReader() e GetDefaultWriter() metodi e passare il tipo per questo costruttore.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.

Si applica a