System.String.CompareTo 方法 (Object)
方法描述
将此实例与指定的 Object 进行比较，并指示此实例在排序顺序中是位于指定的 Object 之前、之后还是与其出现在同一位置。
语法定义(C# System.String.CompareTo 方法 (Object) 的用法)
public int CompareTo( Object value )
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| value | System-Object | 一个对象，其计算结果为 String。 |
| 返回值 | System.Int32 | 一个 32 位带符号整数，该整数指示此实例在排序顺序中是位于 value 参数之前、之后还是与其出现在同一位置。 值 Condition 小于零 此实例位于 value 之前。 零 此实例在排序顺序中的位置与 value 相同。 大于零 此实例位于 value 之后。 - 或 - value 为 null。 |
提示和注释
value 必须为 String 对象。
警告
CompareTo 方法主要用于排序或按字母顺序排列操作。 如果方法调用的主要目的是确定两个字符串是否相等，则不应使用此方法。 若要确定两个字符串是否相等，请调用 Equals 方法。
此方法使用当前区域性执行单词（区分大小写和区域性）比较。 有关字、字符串和顺序排序的更多信息，请参见 System.Globalization.CompareOptions。
有关此方法的行为的更多信息，请参见 String.Compare(String, String) 方法的备注部分。
System.String.CompareTo 方法 (Object)例子
下面的示例演示如何对 Object 使用 CompareTo 方法。
using System;
public class MyClass {}
public class ArgExceptionExample
{
public static void Main()
{
MyClass my = new MyClass();
string s = "sometext";
try
{
int i = s.CompareTo(my);
}
catch (Exception e)
{
Console.WriteLine("Error: {0}",e.ToString());
}
}
}
异常
| 异常 | 异常描述 |
|---|---|
| ArgumentException | value 不是 String。 |
版本信息
.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。