This documentation is archived and is not being maintained.

ResourceSet.GetString Method (String, Boolean)

Searches for a String resource with the specified name in a case-insensitive manner, if requested.

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

public virtual string GetString (
	string name,
	bool ignoreCase
)
public String GetString (
	String name, 
	boolean ignoreCase
)
public function GetString (
	name : String, 
	ignoreCase : boolean
) : String

Parameters

name

Name of the resource to search for.

ignoreCase

Indicates whether the case of the case of the specified name should be ignored.

Return Value

The value of a resource, if the value is a String.

Exception typeCondition

ArgumentNullException

The name parameter is a null reference (Nothing in Visual Basic).

InvalidOperationException

The resource with the specified name is not a String or the current ResourceSet has been closed.

If the value of the ignoreCase parameter is true, a resource with the name "Resource" is equivalent to the resource with the name "resource". Note, however, that this method always performs case-insensitive string comparisons using CultureInfo.InvariantCulture. The advantage is that results of case-insensitive string comparisons performed by this method are the same on all computers regardless of culture. The disadvantage is that the results are not consistent with the casing rules of all cultures.

For example, the Turkish alphabet has two versions of the character I: one with a dot and one without a dot. In Turkish, the character I (Unicode 0049) is considered the uppercase version of a different character ı (Unicode 0131). The character i (Unicode 0069) is considered the lowercase version of yet another character İ (Unicode 0130). According to these casing rules, a case-insensitive string comparison of the characters i (Unicode 0069) and I (Unicode 0049) should fail for the culture "tr-TR" (Turkish in Turkey). Using the GetString method with ignoreCase set to true, this comparison succeeds.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0
Show: