String::ToUpperInvariant Method ()
Returns a copy of this String object converted to uppercase using the casing rules of the invariant culture.
Assembly: mscorlib (in mscorlib.dll)
The invariant culture represents a culture that is culture-insensitive. It is associated with the English language but not with a specific country or region. For more information, see the CultureInfo::InvariantCulture property.
If your application depends on the case of a string changing in a predictable way that is unaffected by the current culture, use the ToUpperInvariant method. The ToUpperInvariant method is equivalent to ToUpper(CultureInfo.InvariantCulture). The method is recommended when a collection of strings must appear in a predictable order in a user interface control.
Note |
|---|
This method does not modify the value of the current instance. Instead, it returns a new string in which all characters in the current instance are converted to uppercase. |
If you need the lowercase or uppercase version of an operating system identifier, such as a file name, named pipe, or registry key, use the ToLowerInvariant or ToUpperInvariant methods.
The following example defines a string array that contains a single word in a number of languages. The ToUpperInvariant method is used to populate the elements of a parallel array with the case-insensitive version of each word. The Array::Sort<TKey, TValue>(array<TKey>^, array<TValue>^, IComparer<TKey>^) method is used to sort the case-sensitive array based on the order of elements in the uppercase array to ensure that elements appear in the same order regardless of language.
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 4.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
