String.EndsWith Method (String, Boolean, CultureInfo)
Determines whether the end of this string instance matches the specified string when compared using the specified culture.
Assembly: mscorlib (in mscorlib.dll)
Public Function EndsWith ( value As String, ignoreCase As Boolean, culture As CultureInfo ) As Boolean
Parameters
- value
-
Type:
System.String
The string to compare to the substring at the end of this instance.
- ignoreCase
-
Type:
System.Boolean
true to ignore case during the comparison; otherwise, false.
- culture
-
Type:
System.Globalization.CultureInfo
Cultural information that determines how this instance and value are compared. If culture is null, the current culture is used.
Return Value
Type: System.Booleantrue if the value parameter matches the end of this string; otherwise, false.
| Exception | Condition |
|---|---|
| ArgumentNullException | value is null. |
This method compares the value parameter to the substring at the end of this string that is the same length as value, and returns a value that indicates whether they are equal. To be equal, value must be a reference to this same instance or match the end of this string.
This method performs a word (culture-sensitive) comparison using the specified casing and culture.
The following example determines whether a string occurs at the end of another string. The EndsWith method is called several times using case sensitivity, case insensitivity, and different cultures that influence the results of the search.
' This code example demonstrates the ' System.String.EndsWith(String, ..., CultureInfo) method. Imports System Imports System.Threading Imports System.Globalization Class Sample Public Shared Sub Main() Dim msg1 As String = "Search for the target string ""{0}"" in the string ""{1}""." & vbCrLf Dim msg2 As String = "Using the {0} - ""{1}"" culture:" Dim msg3 As String = " The string to search ends with the target string: {0}" Dim result As Boolean = False Dim ci As CultureInfo ' Define a target string to search for. ' U+00c5 = LATIN CAPITAL LETTER A WITH RING ABOVE Dim capitalARing As String = "Å" ' Define a string to search. ' The result of combining the characters LATIN SMALL LETTER A and COMBINING ' RING ABOVE (U+0061, U+030a) is linguistically equivalent to the character ' LATIN SMALL LETTER A WITH RING ABOVE (U+00e5). Dim xyzARing As String = "xyz" & "å" ' Clear the screen and display an introduction. Console.Clear() ' Display the string to search for and the string to search. Console.WriteLine(msg1, capitalARing, xyzARing) ' Search using English-United States culture. ci = New CultureInfo("en-US") Console.WriteLine(msg2, ci.DisplayName, ci.Name) Console.WriteLine("Case sensitive:") result = xyzARing.EndsWith(capitalARing, False, ci) Console.WriteLine(msg3, result) Console.WriteLine("Case insensitive:") result = xyzARing.EndsWith(capitalARing, True, ci) Console.WriteLine(msg3, result) Console.WriteLine() ' Search using Swedish-Sweden culture. ci = New CultureInfo("sv-SE") Console.WriteLine(msg2, ci.DisplayName, ci.Name) Console.WriteLine("Case sensitive:") result = xyzARing.EndsWith(capitalARing, False, ci) Console.WriteLine(msg3, result) Console.WriteLine("Case insensitive:") result = xyzARing.EndsWith(capitalARing, True, ci) Console.WriteLine(msg3, result) End Sub 'Main End Class 'Sample ' 'Note: This code example was executed on a console whose user interface 'culture is "en-US" (English-United States). ' 'This code example produces the following results: ' 'Search for the target string "Å" in the string "xyza°". ' 'Using the English (United States) - "en-US" culture: 'Case sensitive: ' The string to search ends with the target string: False 'Case insensitive: ' The string to search ends with the target string: True ' 'Using the Swedish (Sweden) - "sv-SE" culture: 'Case sensitive: ' The string to search ends with the target string: False 'Case insensitive: ' The string to search ends with the target string: False '
Available since 2.0