String::ToUpper Method (CultureInfo^)
Returns a copy of this string converted to uppercase, using the casing rules of the specified culture.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- culture
-
Type:
System.Globalization::CultureInfo^
An object that supplies culture-specific casing rules.
| Exception | Condition |
|---|---|
| ArgumentNullException | culture is null. |
The casing rules of the culture specified by the culture parameter determine the way the case of a string is changed.
 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 pass the ToUpper(CultureInfo^) method a CultureInfo object other than CultureInfo::InvariantCulture, the casing operation will take culture-specific rules into account. 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 method. This produces the same result in every culture and performs more efficiently.
The following example converts a string of lowercase characters to two strings of uppercase characters using the English-United States and Turkish-Turkey cultures, then compares the uppercase strings. The uppercase strings are identical except that for each occurrence of the Unicode LATIN CAPITAL LETTER I in one string, the other string contains LATIN CAPITAL LETTER I WITH DOT ABOVE.
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0