System.String.StartsWith 方法 (String, StringComparison)
方法描述
确定在使用指定的比较选项进行比较时此字符串实例的开头是否与指定的字符串匹配。
语法定义(C# System.String.StartsWith 方法 (String, StringComparison) 的用法)
[ComVisibleAttribute(false)] public bool StartsWith( string value, StringComparison comparisonType )
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| value | System-String | 要比较的字符串。 |
| comparisonType | System-StringComparison | 枚举值之一，用于确定如何比较此字符串与 value。 |
| 返回值 | System.Boolean | true （如果该实例以 value 开头；否则为 false）。 |
提示和注释
StartsWith 方法将 value 参数与位于此字符串开头的子字符串进行比较，并返回指示它们是否相等的值。 若要相等，value 必须是对此同一字符串的引用，必须为空字符串 ("")，或者必须与此字符串的开头匹配。 StartsWith 方法执行的比较类型取决于 comparisonType 参数的值。 比较可以使用当前区域性的约定（StringComparison.CurrentCulture 和 StringComparison.CurrentCultureIgnoreCase）或固定区域性（StringComparison.InvariantCulture 和 StringComparison.InvariantCultureIgnoreCase），它也可以是逐个字符进行码位比较（StringComparison.Ordinal 或 StringComparison.OrdinalIgnoreCase）。 比较可以是区分大小写的（StringComparison.CurrentCulture、StringComparison.InvariantCulture、或 StringComparison.Ordinal），也可以忽略大小写（StringComparison.CurrentCultureIgnoreCase、StringComparison.InvariantCultureIgnoreCase、StringComparison.OrdinalIgnoreCase）。
System.String.StartsWith 方法 (String, StringComparison)例子
请注意，当字符串实例包含连字时，带有其连续字符的区分区域性的比较会成功地匹配。
using System;
public class Example
{
public static void Main()
{
string[,] strings = { {"ABCdef", "abc" },
{"ABCdef", "abc" },
{"œil","oe" },
{ "læring}", "lae" } };
for (int ctr1 = strings.GetLowerBound(0); ctr1 <= strings.GetUpperBound(0); ctr1++)
{
foreach (string cmpName in Enum.GetNames(typeof(StringComparison)))
{
StringComparison strCmp = (StringComparison) Enum.Parse(typeof(StringComparison),
cmpName);
string instance = strings[ctr1, 0];
string value = strings[ctr1, 1];
Console.WriteLine("{0} starts with {1}: {2} ({3} comparison)",
instance, value,
instance.StartsWith(value, strCmp),
strCmp);
}
Console.WriteLine();
}
}
}
// The example displays the following output:
// ABCdef starts with abc: False (CurrentCulture comparison)
// ABCdef starts with abc: True (CurrentCultureIgnoreCase comparison)
// ABCdef starts with abc: False (InvariantCulture comparison)
// ABCdef starts with abc: True (InvariantCultureIgnoreCase comparison)
// ABCdef starts with abc: False (Ordinal comparison)
// ABCdef starts with abc: True (OrdinalIgnoreCase comparison)
//
// ABCdef starts with abc: False (CurrentCulture comparison)
// ABCdef starts with abc: True (CurrentCultureIgnoreCase comparison)
// ABCdef starts with abc: False (InvariantCulture comparison)
// ABCdef starts with abc: True (InvariantCultureIgnoreCase comparison)
// ABCdef starts with abc: False (Ordinal comparison)
// ABCdef starts with abc: True (OrdinalIgnoreCase comparison)
//
// œil starts with oe: True (CurrentCulture comparison)
// œil starts with oe: True (CurrentCultureIgnoreCase comparison)
// œil starts with oe: True (InvariantCulture comparison)
// œil starts with oe: True (InvariantCultureIgnoreCase comparison)
// œil starts with oe: False (Ordinal comparison)
// œil starts with oe: False (OrdinalIgnoreCase comparison)
//
// læring} starts with lae: True (CurrentCulture comparison)
// læring} starts with lae: True (CurrentCultureIgnoreCase comparison)
// læring} starts with lae: True (InvariantCulture comparison)
// læring} starts with lae: True (InvariantCultureIgnoreCase comparison)
// læring} starts with lae: False (Ordinal comparison)
// læring} starts with lae: False (OrdinalIgnoreCase comparison)
异常
| 异常 | 异常描述 |
|---|---|
| ArgumentNullException | value 为 null。 |
| ArgumentException | comparisonType 不是一个 StringComparison 值。 |
版本信息
.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 系统要求。