导出 (0) 打印
全部展开
此文章由机器翻译。 将光标移到文章的句子上,以查看原文。 更多信息。
译文
原文

String.Compare 方法 (String, Int32, String, Int32, Int32, Boolean)

比较两个指定的 String 对象的子字符串(忽略或考虑其大小写),并返回一个整数,指示二者在排序顺序中的相对位置。

命名空间:  System
程序集:  mscorlib(在 mscorlib.dll 中)

public static int Compare(
	string strA,
	int indexA,
	string strB,
	int indexB,
	int length,
	bool ignoreCase
)

参数

strA
类型:System.String
要在比较中使用的第一个字符串。
indexA
类型:System.Int32
strA 中子字符串的位置。
strB
类型:System.String
要在比较中使用的第二个字符串。
indexB
类型:System.Int32
strB 中子字符串的位置。
length
类型:System.Int32
要比较的子字符串中字符的最大数量。
ignoreCase
类型:System.Boolean
要在比较过程中忽略大小写,则为 true;否则为 false

返回值

类型:System.Int32
一个 32 位带符号整数,指示两个比较数之间的词法关系。

条件

小于零

strA 中的子字符串小于 strB 中的子字符串。

子字符串相等,或者 length 为零。

大于零

strA 中的子字符串大于 strB 中的子字符串。

异常条件
ArgumentOutOfRangeException

indexA 大于 strA.Length

- 或 -

indexB 大于 strB.Length

- 或 -

indexAindexBlength 为负。

- 或 -

indexAindexBnull,而 length 大于零。

strAstrB 中要比较的子字符串分别从 indexAindexB 开始。 indexAindexB 都是从零开始的;也就是说,strAstrB 的第一个字符在位置 0。 第一个子字符串的长度等于 strA 的长度减 indexA 加一。 第二个子字符串的长度等于 strB 的长度减 indexB 加一。

要比较的字符数是两个子字符串的长度和 length 中较少的那一个。 indexAindexBlength 参数必须为非负数。

该比较使用当前区域性获取区域性特定的信息,例如大小写规则和各个字符的字母顺序。 例如,区域性可以指定将某些字符的组合视为单个字符,或者用特殊方法比较大写和小写字符,或者字符的排序顺序取决于它前面或后面的字符。

使用字排序规则执行比较。 有关字、字符串和顺序排序的更多信息,请参见 System.Globalization.CompareOptions

警告说明警告

比较字符串时,您应该调用 Compare(String, Int32, String, Int32, Int32, StringComparison) 方法,这需要您显式指定该方法使用的字符串比较的类型。 有关详细信息,请参阅在 .NET Framework 中使用字符串的最佳做法

一个或者两个比较字都可以是 null 根据定义,任何字符串(包括空字符串 (""))的比较结果都大于 null 引用;两个 null 引用的比较结果为相等。

当发现不相等或已经比较了两个子字符串时,比较就会终止。 但是,如果两个字符串一直比较到其中一个字符串的末尾时仍相同,而另一个字符串仍有剩余字符,则认为仍有剩余字符的字符串较大。 返回值为执行最后一次比较所得的结果。

当比较受区域性特定的大小写规则影响时,可能会发生意外结果。 例如,在土耳其语中,下面的示例将产生错误结果,因为土耳其语的文件系统不会对“file”中的字母“i”使用语义大小写规则。


static bool IsFileURI(String path)
{
    return (String.Compare(path, 0, "file:", 0, 5, true) == 0);
}


需要用固定方式对路径名进行比较。 执行此操作的正确代码如下。


static bool IsFileURI(String path)
{
    return (String.Compare(path, 0, "file:", 0, 5, StringComparison.OrdinalIgnoreCase) == 0);
}


对调用者的说明

字符集包括可忽略字符。 它在执行一个语言或区分区域性的比较时, Compare(String, Int32, String, Int32, Int32, Boolean) 方法不考虑这些字符。 若要识别比较中的可忽略字符,请调用 Compare(String, Int32, String, Int32, Int32, StringComparison) 方法并为comparisonType 参数提供 CompareOptions.OrdinalCompareOptions.OrdinalIgnoreCase 值。

下面的示例对两个仅大小写不同的子字符串进行两次比较。 第一次比较忽略大小写,第二次比较考虑大小写。


// Sample for String.Compare(String, Int32, String, Int32, Int32, Boolean)
using System;

class Sample {
    public static void Main() {
//                 0123456
    String str1 = "MACHINE";
    String str2 = "machine";
    String str;
    int result;

    Console.WriteLine();
    Console.WriteLine("str1 = '{0}', str2 = '{1}'", str1, str2);
    Console.WriteLine("Ignore case:");
    result = String.Compare(str1, 2, str2, 2, 2, true);
    str = ((result < 0) ? "less than" : ((result > 0) ? "greater than" : "equal to"));
    Console.Write("Substring '{0}' in '{1}' is ", str1.Substring(2, 2), str1);
    Console.Write("{0} ", str);
    Console.WriteLine("substring '{0}' in '{1}'.", str2.Substring(2, 2), str2);

    Console.WriteLine();
    Console.WriteLine("Honor case:");
    result = String.Compare(str1, 2, str2, 2, 2, false);
    str = ((result < 0) ? "less than" : ((result > 0) ? "greater than" : "equal to"));
    Console.Write("Substring '{0}' in '{1}' is ", str1.Substring(2, 2), str1);
    Console.Write("{0} ", str);
    Console.WriteLine("substring '{0}' in '{1}'.", str2.Substring(2, 2), str2);
    }
}
/*
This example produces the following results:

str1 = 'MACHINE', str2 = 'machine'
Ignore case:
Substring 'CH' in 'MACHINE' is equal to substring 'ch' in 'machine'.

Honor case:
Substring 'CH' in 'MACHINE' is greater than substring 'ch' in 'machine'.
*/


.NET Framework

受以下版本支持:4.5.2、4.5.1、4.5、4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

受以下版本支持:4、3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(不支持服务器核心角色), Windows Server 2008 R2(支持带 SP1 或更高版本的服务器核心角色;不支持 Itanium)

.NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参阅.NET Framework 系统要求

社区附加资源

添加
显示:
© 2014 Microsoft