Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

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)

abstract GetString : 
        name:string * 
        ignoreCase:bool -> string  
override GetString : 
        name:string * 
        ignoreCase:bool -> string

Parameters

name
Type: System.String

Name of the resource to search for.

ignoreCase
Type: System.Boolean

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

Return Value

Type: System.String
The value of a resource, if the value is a String.

ExceptionCondition
ArgumentNullException

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

InvalidOperationException

The resource specified by name is not a String.

ObjectDisposedException

The object has been closed or disposed.

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.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft