System.String.EndsWith 方法 (String)
方法描述
确定此字符串实例的结尾是否与指定的字符串匹配。
语法定义(C# System.String.EndsWith 方法 (String) 的用法)
public bool EndsWith( string value )
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| value | System-String | 要与此实例末尾的子字符串进行比较的字符串。 |
| 返回值 | System.Boolean | 如果 value 与此实例的末尾匹配，则为 true；否则为 false。 |
提示和注释
此方法将 value 与位于此实例末尾、与 value 长度相同的子字符串进行比较，并返回它们是否相等的指示。 若要相等，value 必须是对此同一实例的引用，或者与此实例的末尾匹配。
此方法使用当前区域性执行单词（区分大小写和区域性）比较。
对调用者的说明
如 在 .NET Framework 中使用字符串的最佳做法 中所述，我们建议您避免调用替换默认值的字符串比较方法，而是调用需要显式指定参数的方法。 若要使用当前区域性的字符串比较规则确定字符串是否以特定子字符串开头，请为它的 comparisonType 参数使用 StringComparison.CurrentCulture 的值调用 EndsWith(String, StringComparison) 方法重载。
System.String.EndsWith 方法 (String)例子
下面的示例演示如何使用 EndsWith 方法作为从一行末尾删除 HTML 结束标记的例程的一部分。
using System;
public class EndsWithTest {
public static void Main() {
// process an input file that contains html tags.
// this sample checks for multiple tags at the end of the line, rather than simply
// removing the last one.
// note: HTML markup tags always end in a greater than symbol (>).
string [] strSource = { "This is bold text", "This is large Text
",
"This has multiple tags",
"This has embedded tags.",
"This line simply ends with a greater than symbol, it should not be modified>" };
Console.WriteLine("The following lists the items before the ends have been stripped:");
Console.WriteLine("-----------------------------------------------------------------");
// print out the initial array of strings
foreach ( string s in strSource )
Console.WriteLine( s );
Console.WriteLine();
Console.WriteLine("The following lists the items after the ends have been stripped:");
Console.WriteLine("----------------------------------------------------------------");
// print out the array of strings
foreach ( string s in strSource )
Console.WriteLine( StripEndTags( s ) );
}
private static string StripEndTags( string item ) {
// try to find a tag at the end of the line using EndsWith
if (item.Trim().EndsWith(">")) {
// now search for the opening tag...
int lastLocation = item.LastIndexOf( "= 0 )
item = item.Substring( 0, lastLocation );
}
return item;
}
}
异常
| 异常 | 异常描述 |
|---|---|
| ArgumentNullException | value 为 null。 |
版本信息
.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 系统要求。