String 类

System.String.Equals 方法 (String, String, StringComparison)

上一篇：System.String.Equals(String,StringComparison) 方法下一篇：System.String.Format(String,Object) 方法

方法描述

确定两个指定的 String 对象是否具有相同的值。参数指定区域性、大小写以及比较所用的排序规则。

语法定义(C# System.String.Equals 方法 (String, String, StringComparison) 的用法)

public static bool Equals(
	string a,
	string b,
	StringComparison comparisonType
)

参数/返回值

参数值/返回值	参数类型/返回类型	参数描述/返回描述
a	System-String	要比较的第一个字符串，或 null。
b	System-String	要比较的第二个字符串，或 null。
comparisonType	System-StringComparison	枚举值之一，用于指定比较的规则。
返回值	System.Boolean	如果 a 参数的值等于 b 参数的值，则为 true；否则为 false。

提示和注释

comparisonType 参数指示比较应使用当前区域性还是固定区域性，应考虑还是忽略两个待比较字符串的大小写，以及应使用字排序规则还是序号排序规则。

System.String.Equals 方法 (String, String, StringComparison)例子

下面的示例使用 Equals 方法的三个版本确定 String 对象与 StringBuilder 对象是否相等。

// Sample for String.Equals(Object)
//            String.Equals(String)
//            String.Equals(String, String)
using System;
using System.Text;

class Sample {
    public static void Main() {
    StringBuilder sb = new StringBuilder("abcd");
    String      str1 = "abcd";
    String      str2 = null;
    Object	o2   = null;

    Console.WriteLine();
    Console.WriteLine(" *  The value of String str1 is '{0}'.", str1);
    Console.WriteLine(" *  The value of StringBuilder sb is '{0}'.", sb.ToString());

    Console.WriteLine();
    Console.WriteLine("1a) String.Equals(Object). Object is a StringBuilder, not a String.");
    Console.WriteLine("    Is str1 equal to sb?: {0}", str1.Equals(sb));

    Console.WriteLine();
    Console.WriteLine("1b) String.Equals(Object). Object is a String.");
    str2 = sb.ToString();
    o2   = str2;
    Console.WriteLine(" *  The value of Object o2 is '{0}'.", o2);
    Console.WriteLine("    Is str1 equal to o2?: {0}", str1.Equals(o2));

    Console.WriteLine();
    Console.WriteLine(" 2) String.Equals(String)");
    Console.WriteLine(" *  The value of String str2 is '{0}'.", str2);
    Console.WriteLine("    Is str1 equal to str2?: {0}", str1.Equals(str2));

    Console.WriteLine();
    Console.WriteLine(" 3) String.Equals(String, String)");
    Console.WriteLine("    Is str1 equal to str2?: {0}", String.Equals(str1, str2));
    }
}
/*
This example produces the following results:

 *  The value of String str1 is 'abcd'.
 *  The value of StringBuilder sb is 'abcd'.

1a) String.Equals(Object). Object is a StringBuilder, not a String.
    Is str1 equal to sb?: False

1b) String.Equals(Object). Object is a String.
 *  The value of Object o2 is 'abcd'.
    Is str1 equal to o2?: True

 2) String.Equals(String)
 *  The value of String str2 is 'abcd'.
    Is str1 equal to str2?: True

 3) String.Equals(String, String)
    Is str1 equal to str2?: True
*/

异常

异常	异常描述
ArgumentException	comparisonType 不是一个 StringComparison 值。

命名空间

namespace: System

程序集: mscorlib（在 mscorlib.dll 中）

版本信息

.NET Framework 受以下版本支持：4、3.5、3.0、2.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 系统要求。