CompareInfo::GetCompareInfo Method (String^)
.NET Framework (current version)
Initializes a new CompareInfo object that is associated with the culture with the specified name.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- name
-
Type:
System::String^
A string representing the culture name.
Return Value
Type: System.Globalization::CompareInfo^A new CompareInfo object associated with the culture with the specified identifier and using string comparison methods in the current Assembly.
| Exception | Condition |
|---|---|
| ArgumentNullException | name is null. |
| ArgumentException | name is an invalid culture name. |
The following example compares portions of two strings using the different CompareInfo objects:
CompareInfo object associated with the Spanish (Spain) culture with international sort
CompareInfo object associated with the Spanish (Spain) culture with traditional sort
CompareInfo object associated with the InvariantCulture
// The following code example compares two strings using the different CompareInfo instances: // a CompareInfo instance associated with the S"Spanish - Spain" culture with international sort, // a CompareInfo instance associated with the S"Spanish - Spain" culture with traditional sort, and // a CompareInfo instance associated with the InvariantCulture. using namespace System; using namespace System::Globalization; int main() { // Defines the strings to compare. String^ myStr1 = "calle"; String^ myStr2 = "calor"; // Uses GetCompareInfo to create the CompareInfo that // uses the S"es-ES" culture with international sort. CompareInfo^ myCompIntl = CompareInfo::GetCompareInfo( "es-ES" ); // Uses GetCompareInfo to create the CompareInfo that // uses the S"es-ES" culture with traditional sort. CompareInfo^ myCompTrad = CompareInfo::GetCompareInfo( 0x040A ); // Uses the CompareInfo property of the InvariantCulture. CompareInfo^ myCompInva = CultureInfo::InvariantCulture->CompareInfo; // Compares two strings using myCompIntl. Console::WriteLine( "Comparing \"{0}\" and \"{1}\"", myStr1, myStr2 ); Console::WriteLine( " With myCompIntl::Compare: {0}", myCompIntl->Compare( myStr1, myStr2 ) ); Console::WriteLine( " With myCompTrad::Compare: {0}", myCompTrad->Compare( myStr1, myStr2 ) ); Console::WriteLine( " With myCompInva::Compare: {0}", myCompInva->Compare( myStr1, myStr2 ) ); } /* This code produces the following output. Comparing "calle" and "calor" With myCompIntl::Compare: -1 With myCompTrad::Compare: 1 With myCompInva::Compare: -1 */
Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Show: