ResourceManager Konstruktoren

Definition

Initialisiert eine neue Instanz der ResourceManager-Klasse.Initializes a new instance of the ResourceManager class.

Überlädt

ResourceManager()

Initialisiert eine neue Instanz der ResourceManager-Klasse mit Standardwerten.Initializes a new instance of the ResourceManager class with default values.

ResourceManager(Type)

Initialisiert eine neue Instanz der ResourceManager-Klasse, die Ressourcen in Satellitenassemblys auf der Grundlage der Informationen aus dem angegebenen Typobjekt sucht.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)

Initialisiert eine neue Instanz der ResourceManager-Klasse zum Suchen von Ressourcen in Dateien mit dem angegebenen Stammnamen in der angegebenen Assembly.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)

Initialisiert eine neue Instanz der ResourceManager-Klasse, die eine angegebene ResourceSet-Klasse verwendet, um Ressourcen in Dateien mit dem angegebenen Stammnamen in der angegebenen Assembly zu suchen.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()

Initialisiert eine neue Instanz der ResourceManager-Klasse mit Standardwerten.Initializes a new instance of the ResourceManager class with default values.

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

Hinweise

Dieser Konstruktor ist nur nützlich, wenn Sie eine eigene Klasse schreiben, die von der ResourceManager-Klasse abgeleitet ist.This constructor is useful only if you write your own class that derives from the ResourceManager class.

ResourceManager(Type)

Initialisiert eine neue Instanz der ResourceManager-Klasse, die Ressourcen in Satellitenassemblys auf der Grundlage der Informationen aus dem angegebenen Typobjekt sucht.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)

Parameter

resourceSource
Type

Ein Typ, aus dem der Ressourcen-Manager alle Informationen zum Suchen von RESOURCES-Dateien ableitet.A type from which the resource manager derives all information for finding .resources files.

Ausnahmen

Der resourceSource-Parameter ist null.The resourceSource parameter is null.

Beispiele

Im folgenden Beispiel wird der ResourceManager(Type)-Konstruktor verwendet, um ein ResourceManager-Objekt zu instanziieren.The following example uses the ResourceManager(Type) constructor to instantiate a ResourceManager object. Es besteht aus Ressourcen, die aus txt-Dateien für die Kulturen Englisch (en), Französisch (Frankreich) (fr-FR) und Russisch (Russland) (ru-ru) kompiliert wurden.It consists of resources compiled from .txt files for the English (en), French (France) (fr-FR), and Russian (Russia) (ru-RU) cultures. Im Beispiel wird die aktuelle Kultur und die aktuelle Benutzeroberflächen Kultur in Englisch (USA), Französisch (Frankreich), Russisch (Russische Föderation) und Schwedisch (Schweden) geändert.The example changes the current culture and current UI culture to English (United States), French (France), Russian (Russia), and Swedish (Sweden). Anschließend wird die GetString(String)-Methode aufgerufen, um die lokalisierte Zeichenfolge abzurufen, die eine Begrüßung anzeigt, die von der Tageszeit abhängt.It then calls the GetString(String) method to retrieve the localized string, which displays a greeting that depends on the time of day.

Für das Beispiel sind drei textbasierte Ressourcen Dateien erforderlich, wie in der folgenden Tabelle aufgeführt.The example requires three text-based resource files, as listed in the following table. Jede Datei enthält Zeichen folgen Ressourcen mit dem Namen Morning, Afternoonund Evening.Each file includes string resources named Morning, Afternoon, and Evening.

cultureCulture DateinameFile name RessourcennameResource name RessourcenwertResource value
en-USen-US GreetingResources.txtGreetingResources.txt Morning Guten MorgenGood morning
en-USen-US GreetingResources.txtGreetingResources.txt Afternoon Guten TagGood afternoon
en-USen-US GreetingResources.txtGreetingResources.txt Evening Guten AbendGood 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 "-Вечер"Добрый вечер

Mit der folgenden Batchdatei können Sie das Visual Basic Beispiel kompilieren und eine ausführbare Datei mit dem Namen "Gruß. exe" erstellen.You can use the following batch file to compile the Visual Basic example and create an executable named Greet.exe. Um mit C#zu kompilieren, ändern Sie den Compilernamen von vbc in csc und die Dateierweiterung von .vb in .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

Im folgenden finden Sie den Quellcode für das Beispiel (showdate. vb für die Visual Basic Version oder ShowDate.cs für C# die Version des Codes).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!

Zusätzlich zum Definieren einer App-Klasse mit dem Namen "Example" definiert der Quellcode eine interne Klasse, deren Name, GreetingResources, mit dem Basisnamen der Ressourcen Dateien identisch ist.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. Dadurch ist es möglich, ein ResourceManager Objekt durch Aufrufen des ResourceManager(Type)-Konstruktors erfolgreich zu instanziieren.This makes it possible to successfully instantiate a ResourceManager object by calling the ResourceManager(Type) constructor.

Beachten Sie, dass die Ausgabe die entsprechende lokalisierte Zeichenfolge anzeigt, es sei denn, die aktuelle Benutzeroberflächen Kultur ist Schwedisch (Sweden). in diesem Fall werden englischsprachige Ressourcen verwendet.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. Da die schwedischen Sprachressourcen nicht verfügbar sind, verwendet die APP stattdessen die Ressourcen der Standard Kultur gemäß der Definition des NeutralResourcesLanguageAttribute Attributs.Because Swedish language resources are unavailable, the app uses the resources of the default culture, as defined by the NeutralResourcesLanguageAttribute attribute, instead.

Hinweise

Desktop-AppsDesktop Apps

In Desktop-Apps verwendet der Ressourcen-Manager den resourceSource-Parameter, um eine bestimmte Ressourcen Datei wie folgt zu laden:In desktop apps, the resource manager uses the resourceSource parameter to load a particular resource file as follows:

  • Wenn das NeutralResourcesLanguageAttribute-Attribut nicht verwendet wird, um anzugeben, dass sich die Ressourcen der Standard Kultur in einer Satellitenassembly befinden, geht der Ressourcen-Manager davon aus, dass sich die Ressourcen Datei für die Standard Kultur in derselben Assembly befindet wie der durch den resourceSource-Parameter angegebene Typ.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.

  • Der Ressourcen-Manager geht davon aus, dass die Standard Ressourcen Datei denselben Basis Namen wie der durch den resourceSource-Parameter angegebene Typ aufweist.The resource manager assumes that the default resource file has the same base name as the type specified by the resourceSource parameter.

  • Der Ressourcen-Manager verwendet die Standard-ResourceSet-Klasse, um die Ressourcen Datei zu bearbeiten.The resource manager uses the default ResourceSet class to manipulate the resource file.

Wenn beispielsweise ein Typ mit dem Namen "MyCompany. MyProduct. MyType" angegeben ist, sucht der Ressourcen-Manager in der Assembly, die MyType definiert, nach einer resources-Datei mit dem Namen "MyCompany. MyProduct. MyType. Resources".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 generiert der Ressourcen-Designer automatisch Code, der eine internal (in C#) oder Friend (in Visual Basic)-Klasse definiert, deren Name mit dem Basisnamen der resources-Datei für die Standard Kultur identisch ist.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. Dadurch ist es möglich, ein ResourceManager Objekt zu instanziieren und mit einem bestimmten Satz von Ressourcen zu verknüpfen, indem er ein Typobjekt erhält, dessen Name dem Namen der Ressource entspricht, denn solange die Klasse für den Compiler sichtbar ist, müssen die Ressourcen ebenfalls gleich sein.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. Wenn eine resources-Datei z. b. den Namen "" Resource1 "hat, instanziiert die folgende Anweisung ein ResourceManager Objekt, um die resources-Datei mit dem Namen" "Resource1" zu verwalten: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));

Wenn Sie nicht Visual Studio verwenden, können Sie eine Klasse ohne Member erstellen, deren Namespace und Name mit denen der standardmäßigen resources-Datei übereinstimmen.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. Dies wird im Beispiel veranschaulicht.The example provides an illustration.

Windows 8.x StoreWindows 8.x Store-AppsApps

Wichtig

Obwohl die ResourceManager-Klasse in Windows 8.x StoreWindows 8.x Store-Apps unterstützt wird, wird deren Verwendung nicht empfohlen.Although the ResourceManager class is supported in Windows 8.x StoreWindows 8.x Store apps, we do not recommend its use. Verwenden Sie diese Klasse nur, wenn Sie Portable KlassenbibliothekPortable Class Library Projekte entwickeln, die mit Windows 8.x StoreWindows 8.x Store-Apps verwendet werden können.Use this class only when you develop Portable KlassenbibliothekPortable Class Library projects that can be used with Windows 8.x StoreWindows 8.x Store apps. Verwenden Sie stattdessen die Windows. applicationmodel. resources. resourceloader -Klasse, um Ressourcen aus Windows 8.x StoreWindows 8.x Store-apps abzurufen.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-Apps verwendet ResourceManager den resourceSource-Parameter, um die Assembly, den Basisnamen und den Namespace abzuleiten, in denen sich die Ressourcen Elemente in der Paket Ressourcen Index-Datei (PRI) der APP befinden.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. Wenn beispielsweise ein Typ mit dem Namen "MyCompany. MyProduct. MyType" in MyAssemblydefiniert ist, sucht der Ressourcen-Manager nach einem Ressourcen Satz Bezeichner mit dem Namen myAssembly und sucht in diesem Ressourcen Satz nach einem Bereich MyCompany. MyProduct. MyType.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. Der Ressourcen-Manager sucht nach Ressourcen Elementen in diesem Bereich unter dem Standardkontext (aktuelle Kultur, aktuelle Einstellung für hohe Kontraste usw.).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)

Initialisiert eine neue Instanz der ResourceManager-Klasse zum Suchen von Ressourcen in Dateien mit dem angegebenen Stammnamen in der angegebenen Assembly.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

Parameter

baseName
String

Der Stammname der Ressourcendatei ohne Erweiterung, aber einschließlich eines beliebigen vollqualifizierten Namespacenamens.The root name of the resource file without its extension but including any fully qualified namespace name. Der Stammname der Ressourcendatei "MyApplication.MyResource.en-US.resources" lautet beispielsweise "MyApplication.MyResource".For example, the root name for the resource file named MyApplication.MyResource.en-US.resources is MyApplication.MyResource.

assembly
Assembly

Die Hauptassembly für die Ressourcen.The main assembly for the resources.

Ausnahmen

Der baseName-Parameter oder der assembly-Parameter ist null.The baseName or assembly parameter is null.

Beispiele

Im folgenden Beispiel wird eine einfache nicht lokalisierte "Hallo Welt"-App verwendet, um den ResourceManager(String, Assembly)-Konstruktor zu veranschaulichen.The following example uses a simple non-localized "Hello World" app to illustrate the ResourceManager(String, Assembly) constructor. Das folgende Beispiel zeigt den Inhalt einer Textdatei mit dem Namen "exampleresources. txt".The following shows the contents of a text file named ExampleResources.txt. Wenn die APP kompiliert ist, wird die Ressource in die Haupt-App-Assembly eingebettet.When the app is compiled, the resource is embedded in the main app assembly.

Greeting=Hello

Die Textdatei kann mithilfe des Ressourcen Datei-Generators (Resgen. exe) an der Eingabeaufforderung wie folgt in eine binäre Ressourcen Datei konvertiert werden: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

Im folgenden Beispiel wird der ausführbare Code bereitstellt, der ein ResourceManager Objekt instanziiert, den Benutzer zur Eingabe eines Namens auffordert und eine Begrüßung anzeigt.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!

Er kann mit dem folgenden Befehl in Visual Basic kompiliert werden:It can be compiled by using the following command in Visual Basic:

vbc Example.vb /resource:ExampleResources.resources

oder verwenden Sie den folgenden Befehl in C#:or by using the following command in C#:

csc Example.cs /resource:ExampleResources.resources

Beachten Sie, dass im Beispiel ein Verweis auf die Assembly mit der Ressourcen Datei abgerufen wird, indem ein in dieser Assembly definierter Typ an die typeof Funktion ( C#in) oder die GetType-Funktion (in Visual Basic) übergeben und der Wert der Type.Assembly Eigenschaft abgerufen wird.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.

Hinweise

Desktop-AppsDesktop Apps

In Desktop-Apps sollten die einzelnen kulturspezifischen Ressourcen Dateien in Satellitenassemblys enthalten sein, und die Ressourcen Datei der Standard Kultur sollte in der Hauptassembly enthalten sein.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. Es wird davon ausgegangen, dass eine Satellitenassembly Ressourcen für eine einzelne Kultur enthält, die im Manifest der Assembly angegeben ist, und wird bei Bedarf geladen.A satellite assembly is assumed to contain resources for a single culture specified in that assembly's manifest, and is loaded as necessary.

Hinweis

Wenn Sie Ressourcen direkt aus Ressourcen Dateien abrufen möchten, anstatt Sie aus Assemblys abzurufen, müssen Sie stattdessen die CreateFileBasedResourceManager-Methode aufrufen, um ein ResourceManager-Objekt zu instanziieren.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.

Wenn die durch baseName identifizierte Ressourcen Datei in assemblynicht gefunden werden kann, instanziiert die-Methode ein ResourceManager-Objekt, aber der Versuch, eine bestimmte Ressource abzurufen, löst in der Regel MissingManifestResourceExceptionaus.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. Weitere Informationen zur Diagnose der Ursache der Ausnahme finden Sie im Abschnitt "behandeln der MissingManifestResourceException-Ausnahme" im Thema ResourceManager-Klasse.For information about diagnosing the cause of the exception, see the "Handling the MissingManifestResourceException Exception" section of the ResourceManager class topic.

Windows 8.x StoreWindows 8.x Store-AppsApps

Wichtig

Obwohl die ResourceManager-Klasse in Windows 8.x StoreWindows 8.x Store-Apps unterstützt wird, wird deren Verwendung nicht empfohlen.Although the ResourceManager class is supported in Windows 8.x StoreWindows 8.x Store apps, we do not recommend its use. Verwenden Sie diese Klasse nur, wenn Sie Portable KlassenbibliothekPortable Class Library Projekte entwickeln, die mit Windows 8.x StoreWindows 8.x Store-Apps verwendet werden können.Use this class only when you develop Portable KlassenbibliothekPortable Class Library projects that can be used with Windows 8.x StoreWindows 8.x Store apps. Verwenden Sie stattdessen die Windows. applicationmodel. resources. resourceloader -Klasse, um Ressourcen aus Windows 8.x StoreWindows 8.x Store-apps abzurufen.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-Apps verwendet der Ressourcen-Manager den einfachen Namen des assembly-Parameters, um nach einem passenden Ressourcen Satz in der Paket Ressourcen Indexdatei (PRI) der APP zu suchen.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. Der baseName-Parameter wird verwendet, um ein Ressourcen Element innerhalb des Ressourcen Satzes zu suchen.The baseName parameter is used to look up a resource item within the resource set. Der Stammname für PortableLibrary1.Resource1.de-de. resources lautet z. b. PortableLibrary1. "Resource1.For example, the root name for PortableLibrary1.Resource1.de-DE.resources is PortableLibrary1.Resource1.

Hinweise für Vererber

Dieser Konstruktor verwendet die vom System bereitgestellte ResourceSet Implementierung.This constructor uses the system-provided ResourceSet implementation. Wenn Sie ein benutzerdefiniertes Ressourcen Dateiformat verwenden möchten, sollten Sie von der ResourceSet-Klasse ableiten, die GetDefaultReader()-und GetDefaultWriter()-Methoden überschreiben und diesen Typ an den ResourceManager(String, Assembly, Type)-Konstruktor übergeben.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. Die Verwendung eines benutzerdefinierten ResourceSet kann nützlich sein, um die Richtlinie zum Zwischenspeichern von Ressourcen zu steuern oder Ihr eigenes Ressourcen Dateiformat zu unterstützenUsing 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)

Initialisiert eine neue Instanz der ResourceManager-Klasse, die eine angegebene ResourceSet-Klasse verwendet, um Ressourcen in Dateien mit dem angegebenen Stammnamen in der angegebenen Assembly zu suchen.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

Parameter

baseName
String

Der Stammname der Ressourcendatei ohne Erweiterung, aber einschließlich eines beliebigen vollqualifizierten Namespacenamens.The root name of the resource file without its extension but including any fully qualified namespace name. Der Stammname der Ressourcendatei "MyApplication.MyResource.en-US.resources" lautet beispielsweise "MyApplication.MyResource".For example, the root name for the resource file named MyApplication.MyResource.en-US.resources is MyApplication.MyResource.

assembly
Assembly

Die Hauptassembly für die Ressourcen.The main assembly for the resources.

usingResourceSet
Type

Der Typ des zu verwendenden benutzerdefinierten ResourceSet.The type of the custom ResourceSet to use. Wenn null, wird das für die Laufzeit standardmäßig festgelegte ResourceSet-Objekt verwendet.If null, the default runtime ResourceSet object is used.

Ausnahmen

usingResourceset ist keine von ResourceSet abgeleitete Klasse.usingResourceset is not a derived class of ResourceSet.

Der baseName-Parameter oder der assembly-Parameter ist null.The baseName or assembly parameter is null.

Hinweise

Die einzelnen kulturspezifischen Ressourcen Dateien sollten in Satellitenassemblys enthalten sein, und die Ressourcen Datei der Standard Kultur sollte in der Hauptassembly enthalten sein.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. Es wird davon ausgegangen, dass eine Satellitenassembly Ressourcen für eine einzelne Kultur enthält, die im Manifest der Assembly angegeben ist, und wird bei Bedarf geladen.A satellite assembly is assumed to contain resources for a single culture specified in that assembly's manifest, and is loaded as necessary.

Hinweis

Wenn Sie Ressourcen direkt aus Ressourcen Dateien abrufen möchten, anstatt Sie aus Assemblys abzurufen, müssen Sie stattdessen die CreateFileBasedResourceManager-Methode aufrufen, um ein ResourceManager-Objekt zu instanziieren.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.

Wenn die durch baseName identifizierte Ressourcen Datei in assemblynicht gefunden werden kann, instanziiert die-Methode ein ResourceManager-Objekt, aber der Versuch, eine bestimmte Ressource abzurufen, löst in der Regel MissingManifestResourceExceptionaus.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. Weitere Informationen zur Diagnose der Ursache der Ausnahme finden Sie im Abschnitt "behandeln der MissingManifestResourceException-Ausnahme" im Thema ResourceManager-Klasse.For information about diagnosing the cause of the exception, see the "Handling the MissingManifestResourceException Exception" section of the ResourceManager class topic.

Hinweis

Der usingResourceSet-Parameter wird verwendet, um Ihr eigenes Ressourcen Format zu unterstützen, und wird häufig null.The usingResourceSet parameter is used to support your own resource format, and will commonly be null. Dies unterscheidet sich von dem Konstruktor, der nur eine Type annimmt.This is different from the constructor that takes a Type only.

Hinweise für Aufrufer

Mit diesem Konstruktor können Sie eine ResourceSet-Implementierung angeben.This constructor lets you specify a ResourceSet implementation. Wenn Sie keine bestimmte ResourceSet Implementierung verwenden möchten, aber ein benutzerdefiniertes Ressourcen Dateiformat verwenden möchten, sollten Sie von der ResourceSet Klasse ableiten, die GetDefaultReader()-und GetDefaultWriter() Methoden überschreiben und diesen Typ an diesen Konstruktor übergeben.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.

Gilt für: