This documentation is archived and is not being maintained.

ResourceManager.IgnoreCase Property

Gets or sets a Boolean value indicating whether the current instance of ResourceManager allows case-insensitive resource lookups in the GetString and GetObject methods.

[Visual Basic]
Public Overridable Property IgnoreCase As Boolean
public virtual bool IgnoreCase {get; set;}
public: __property virtual bool get_IgnoreCase();
public: __property virtual void set_IgnoreCase(bool);
public function get IgnoreCase() : Boolean;
public function set IgnoreCase(Boolean);

Property Value

A Boolean value indicating whether the case of the resource names should be ignored.


If the value of the IgnoreCase property is false, a resource with the name "Resource" is not equivalent to the resource with the name "resource". If IgnoreCase is true, a resource with the name "Resource" is equivalent to the resource with the name "resource". Note, however, that when IgnoreCase is true, the ResourceManager.GetString and ResourceManager.GetObject methods perform case-insensitive string comparisons using CultureInfo.InvariantCulture. The advantage is that results of case-insensitive string comparisons performed by these methods 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). If IgnoreCase is true, this comparison succeeds.

Note   For performance reasons, it is best to always specify the correct case for your resource names. IgnoreCase can cause a significant workingset and performance hit.


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

ResourceManager Class | ResourceManager Members | System.Resources Namespace