ResourceManager.GetResourceSet(CultureInfo, Boolean, Boolean) Methode

Definition

Ruft die Ressource ab, die für eine bestimmte Kultur festgelegt wird.Retrieves the resource set for a particular culture.

public:
 virtual System::Resources::ResourceSet ^ GetResourceSet(System::Globalization::CultureInfo ^ culture, bool createIfNotExists, bool tryParents);
public virtual System.Resources.ResourceSet GetResourceSet (System.Globalization.CultureInfo culture, bool createIfNotExists, bool tryParents);
abstract member GetResourceSet : System.Globalization.CultureInfo * bool * bool -> System.Resources.ResourceSet
override this.GetResourceSet : System.Globalization.CultureInfo * bool * bool -> System.Resources.ResourceSet
Public Overridable Function GetResourceSet (culture As CultureInfo, createIfNotExists As Boolean, tryParents As Boolean) As ResourceSet

Parameter

culture
CultureInfo

Die Kultur, deren Ressourcen abgerufen werden sollen.The culture whose resources are to be retrieved.

createIfNotExists
Boolean

true, um den Ressourcensatz zu laden, falls er noch nicht geladen wurde; andernfalls false.true to load the resource set, if it has not been loaded yet; otherwise, false.

tryParents
Boolean

true, um Ressourcenfallback zu verwenden, um eine entsprechende Ressource zu laden, wenn der Ressourcensatz nicht gefunden werden kann; false, um den Ressourcenfallback-Prozess zu umgehen.true to use resource fallback to load an appropriate resource if the resource set cannot be found; false to bypass the resource fallback process.

Gibt zurück

Die Ressource, die für die angegebene Kultur festgelegt wurde.The resource set for the specified culture.

Ausnahmen

Der Parameter culture ist null.The culture parameter is null.

tryParents ist true, es wurde kein passender Satz von Ressourcen gefunden, und es sind keine Ressourcen für die Standardkultur vorhanden.tryParents is true, no usable set of resources has been found, and there are no default culture resources.

Beispiele

Im folgenden Beispiel wird die GetResourceSet-Methode aufgerufen, um kulturspezifische Ressourcen für die Kultur Französisch (Frankreich) abzurufen.The following example calls the GetResourceSet method to retrieve culture-specific resources for the French (France) culture. Anschließend werden alle Ressourcen im Ressourcen Satz aufgelistet.It then enumerates all of the resources in the resource set. Sie enthält den Quellcode für eine ausführbare Datei mit dem Namen "shownumbers. exe".It contains the source code for an executable named ShowNumbers.exe. Sie enthält auch die folgenden beiden Textdateien, die die Namen von Zahlen enthalten.It also includes the following two text file that contain the names of numbers. Der erste, "numresources. txt", enthält die Namen der Zahlen von 1 bis 10 in der englischen Sprache:The first, NumberResources.txt, contains the names of numbers from one to ten in the English language:

  
one=one  
two=two  
three=three  
four=four  
five=five  
six=six  
seven=seven  
eight=eight  
nine=nine  
ten=ten  
  

Die zweite, NumberResources.fr-fr. txt, enthält die Namen der Zahlen von einem bis vier in der französischen Sprache:The second, NumberResources.fr-FR.txt, contains the names of numbers from one to four in the French language:

  
one=un  
two=deux  
three=trois  
four=quatre  
  

Sie können eine Batchdatei verwenden, um die Ressourcen Dateien zu generieren, die englischsprachige Ressourcen Datei in die ausführbare Datei einzubetten und eine Satellitenassembly für die französischsprachigen Ressourcen zu erstellen.You can use a batch file to generate the resource files, embed the English language resource file into the executable, and create a satellite assembly for the French language resources. Im folgenden finden Sie die Batchdatei zum Generieren einer ausführbaren Datei mithilfe des Visual Basic-Compilers:Here's the batch file to generate an executable by using the Visual Basic compiler:

  
resgen NumberResources.txt  
vbc shownumbers.vb /resource:NumberResources.resources  
  
md fr-FR  
resgen NumberResources.fr-FR.txt  
al /out:fr-FR\ShowNumbers.resources.dll /culture:fr-FR /embed:NumberResources.fr-FR.resources  

Für den C# Compiler können Sie die folgende Batchdatei verwenden:For the C# compiler, you can use the following batch file:

  
resgen NumberResources.txt  
csc shownumbers.cs /resource:NumberResources.resources  
  
md fr-FR  
resgen NumberResources.fr-FR.txt  
al /out:fr-FR\ShowNumbers.resources.dll /culture:fr-FR /embed:NumberResources.fr-FR.resources  
  
using System;
using System.Globalization;
using System.Resources;

public class Example
{
   public static void Main()
   {
      String[] numbers = { "one", "two", "three", "four", "five", "six",
                           "seven", "eight", "nine", "ten" };
      var rm = new ResourceManager(typeof(NumberResources));
      ResourceSet rs = rm.GetResourceSet(CultureInfo.CreateSpecificCulture("fr-FR"),
                                         true, false);
      if (rs == null) {
         Console.WriteLine("No resource set.");
         return;
      }

      foreach (var number in numbers)
         Console.WriteLine("{0,-10} '{1}'", number + ":", rs.GetString(number));
   }
}

internal class NumberResources {}
// The example displays the following output:
//       one:       'un'
//       two:       'deux'
//       three:     'trois'
//       four:      'quatre'
//       five:      ''
//       six:       ''
//       seven:     ''
//       eight:     ''
//       nine:      ''
//       ten:       ''
Imports System.Globalization
Imports System.Resources

Module Example
   Public Sub Main()
      Dim numbers() As String = { "one", "two", "three", "four", "five", "six", "seven", "eight", "nine", "ten" }
      Dim rm As New ResourceManager(GetType(NumberResources))
      Dim rs As ResourceSet = rm.GetResourceSet(CultureInfo.CreateSpecificCulture("fr-FR"), True, False)
      If rs Is Nothing Then Console.WriteLine("No resource set.") : Exit Sub
      For Each number In numbers
         Console.WriteLine("{0,-10} '{1}'", number + ":", rs.GetString(number))
      Next            
   End Sub
End Module

Public Class NumberResources
End Class
' The example displays the following output:
'       one:       'un'
'       two:       'deux'
'       three:     'trois'
'       four:      'quatre'
'       five:      ''
'       six:       ''
'       seven:     ''
'       eight:     ''
'       nine:      ''
'       ten:       ''

Beachten Sie Folgendes: Wenn Sie den Wert des createIfNotExists Arguments in falseändern, gibt der Methodenaufrufe nullzurück, da Ressourcen-Manager nicht bereits die französischen Sprachressourcen geladen hat.Note that if you change the value of the createIfNotExists argument to false, the method call returns null, since Resource Manager has not already loaded the French language resources.

Hinweise

Der zurückgegebene Ressourcen Satz stellt die Ressourcen dar, die für die angegebene Kultur lokalisiert sind.The resource set that is returned represents the resources that are localized for the specified culture. Wenn die Ressourcen für diese Kultur nicht lokalisiert wurden und tryParents trueist, verwendet GetResourceSet Ressourcen Fall Back Regeln, um eine entsprechende Ressource zu laden.If the resources have not been localized for that culture and tryParents is true, GetResourceSet uses resource fallback rules to load an appropriate resource. Wenn tryParents false und ein kulturspezifischer Ressourcen Satz nicht gefunden werden kann, gibt die Methode nullzurück.If tryParents is false and a culture-specific resource set cannot be found, the method returns null. Weitere Informationen zum Ressourcen Fall Back finden Sie im Abschnitt "Ressourcen Fall Back-Prozess" im Artikel Verpacken und Bereitstellen von Ressourcen.For more information about resource fallback, see "The Resource Fallback Process" section in the Packaging and Deploying Resources article.

Sicherheit

ReflectionPermission
Wenn Sie spät gebunden durch Mechanismen wie InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[])aufgerufen wird.when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Zugeordnete Enumeration: MemberAccessAssociated enumeration: MemberAccess.

Gilt für:

Siehe auch