Export (0) Print
Expand All

String.EndsWith Method (String, Boolean, CultureInfo)

Determines whether the end of this string instance matches the specified string when compared using the specified culture.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

'Declaration
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 Nothing, the current culture is used.

Return Value

Type: System.Boolean
true if the value parameter matches the end of this string; otherwise, false.

ExceptionCondition
ArgumentNullException

value is Nothing.

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 
'

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft