次の方法で共有


ResourceManager.GetString メソッド (String)

指定した String リソースの値を返します。

Overloads Public Overridable Function GetString( _
   ByVal name As String _) As String
[C#]
public virtual string GetString(stringname);
[C++]
public: virtual String* GetString(String* name);
[JScript]
public function GetString(
   name : String) : String;

パラメータ

  • name
    取得するリソースの名前。

戻り値

呼び出し元の現在のカルチャ用にローカライズされているリソースの値。一致しない場合は null 参照 (Visual Basic では Nothing) が返されます。

例外

例外の種類 条件
ArgumentNullException name パラメータが null 参照 (Visual Basic では Nothing) です。
InvalidOperationException 指定されたリソースの値が文字列ではありません。
MissingManifestResourceException 使用できるリソースのセットが見つからず、ニュートラル カルチャ リソースもありません。

解説

返されるリソースは、現在の Thread のカルチャ設定で決定されているカルチャ用にローカライズされています。この処理には、カルチャの CurrentUICulture プロパティが使用されます。リソースがそのカルチャ用にローカライズされていない場合は、最も近いカルチャ用にローカライズされたリソースが返されます。この処理には、 Parent プロパティが使用されます。それ以外の場合は、 null 参照 (Visual Basic では Nothing) が返されます。

使用できるリソースのセットが見つからない場合、 ResourceManager はニュートラル カルチャのリソースを使用します。このリソースは、通常メイン アセンブリにあります。適切なカルチャ リソースが見つからない場合は、 MissingManifestResourceException がスローされます。

メモ    GetString メソッドはスレッド セーフです。

使用例

 
Imports System
Imports System.Globalization
Imports System.Threading
Imports System.Resources
Imports System.Reflection

Class ResourcesExample
   
    Public Shared Sub Main()
        ' Create a resource manager to retrieve resources.
        Dim rm As 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.
        Dim str As String = rm.GetString("welcome")
         Console.WriteLine(str)
   End Sub
End Class

[C#] 
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);
    }
}

[C++] 
#using <mscorlib.dll>

using namespace System;
using namespace System::Globalization;
using namespace System::Threading;
using namespace System::Resources;
using namespace System::Reflection;


int main() {
    // Create a resource manager to retrieve resources.
    ResourceManager* rm = new ResourceManager(S"items",
        Assembly::GetExecutingAssembly());


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

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

.NET Framework セキュリティ:

参照

ResourceManager クラス | ResourceManager メンバ | System.Resources 名前空間 | ResourceManager.GetString オーバーロードの一覧