Windows Dev Center

Informationen
Das angeforderte Thema wird unten angezeigt. Es ist jedoch nicht in dieser Bibliothek vorhanden.

ResourceManager.GetString-Methode (String)

Aktualisiert: November 2007

Gibt den Wert der angegebenen String-Ressource zurück.

Namespace:  System.Resources
Assembly:  mscorlib (in mscorlib.dll)

public virtual string GetString(
	string name
)
public String GetString(
	String name
)
public function GetString(
	name : String
) : String

Parameter

name
Typ: System.String
Der Name der abzurufenden Ressource.

Rückgabewert

Typ: System.String
Der Wert der Ressource, die für die aktuellen Kultureinstellungen des Aufrufers lokalisiert wurde. Wenn keine Übereinstimmung gefunden wird, wird null zurückgegeben.

AusnahmeBedingung
ArgumentNullException

Der name-Parameter ist null.

InvalidOperationException

Der Wert der angegebenen Ressource ist keine Zeichenfolge.

MissingManifestResourceException

Es wurde kein passender Satz von Ressourcen gefunden, und es sind keine Ressourcen für eine neutrale Kultur vorhanden.

Die zurückgegebene Ressource wird für die Kultur lokalisiert, die durch die Kultureinstellungen des aktuellen Thread bestimmt wird. Dies geschieht mithilfe der CurrentUICulture-Eigenschaft der Kultur. Wenn die Ressource nicht für diese Kultur lokalisiert wurde, wird die zurückgegebene Ressource mit der Parent-Eigenschaft als beste Entsprechung lokalisiert. Andernfalls wird null zurückgegeben.

Wenn kein passender Satz von Ressourcen gefunden wird, greift der ResourceManager auf die neutralen Ressourcen der Kultur zurück, die in der Hauptassembly vorhanden sein sollten. Wenn keine geeignete Kulturressource gefunden wurde, wird eine MissingManifestResourceException ausgelöst.

d17ax2xk.alert_note(de-de,VS.90).gifHinweis:

Die GetString-Methode ist threadsicher.

d17ax2xk.alert_caution(de-de,VS.90).gifVorsicht:

Diese Methode kann weitere Ausnahmen als die aufgelisteten auslösen. Die Ursache dafür könnte darin liegen, dass eine von dieser Methode aufgerufene Methode eine Ausnahme auslöst. Eine FileLoadException kann z. B. ausgelöst werden, wenn beim Bereitstellen oder Installieren einer Satellitenassembly ein Fehler ausgelöst wurde, oder eine SerializationException kann ausgelöst werden, wenn ein benutzerdefinierter Typ beim Deserialisieren des Typs eine benutzerdefinierte Ausnahme auslöst.

Im folgenden Codebeispiel wird eine Zeichenfolgenressource mit der aktuellen UI-Kultur abgerufen.

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

class ResourcesExample 
{
    public static void Main() 
    {
        // Create a resource manager to retrieve resources.
        ResourceManager rm = new ResourceManager("items", 
            Assembly.GetExecutingAssembly());


        // Retrieve the value of the string resource named "welcome".
        // The resource manager will retrieve the value of the  
        // localized resource using the caller's current culture setting.
        String str = rm.GetString("welcome");
        Console.WriteLine(str);
    }
}


import System.*;
import System.Globalization.*;
import System.Threading.*;
import System.Resources.*;
import System.Reflection.*;

class ResourcesExample
{

    public static void main(String[] args)
    {
        // Create a resource manager to retrieve resources.
        ResourceManager rm = new ResourceManager("items", 
            Assembly.GetExecutingAssembly());

        // Retrieve the value of the string resource named "welcome".
        // The resource manager will retrieve the value of the  
        // localized resource using the caller's current culture setting.
        String str = rm.GetString("welcome");
        Console.WriteLine(str);
    } //main
} //ResourcesExample


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC, Xbox 360

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 3.5, 2.0, 1.0

XNA Framework

Unterstützt in: 2.0, 1.0

Community-Beiträge

Anzeigen:
© 2015 Microsoft