Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

String.Equals Method (String)


Determines whether this instance and another specified String object have the same value.

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

Public Function Equals (
	value As String
) As Boolean


Type: System.String

The string to compare to this instance.

Return Value

Type: System.Boolean

true if the value of the value parameter is the same as the value of this instance; otherwise, false. If value is null, the method returns false.

This method performs an ordinal (case-sensitive and culture-insensitive) comparison.

The following example demonstrates the Equals method.It compares the title-cased word "File" with an equivalent word, its lowercase equivalent, its uppercase equivalent, and a word that contains LATIN SMALL LETTER DOTLESS I (U+0131) instead of LATIN SMALL LETTER I (U+0069). Because the Equals(String) method performs an ordinal comparison, only the comparison with an identical word returns true.

Module Example
   Public Sub Main()
      Console.OutputEncoding = System.Text.Encoding.UTF8

      Dim word As String = "File"
      Dim others() As String = { word.ToLower(), word, word.ToUpper(), _
                                 "fıle" }
      For Each other As String In others
         If word.Equals(other) Then 
            Console.WriteLine("{0} = {1}", word, other)
            Console.WriteLine("{0} {1} {2}", word, ChrW(&H2260), other)
         End If      
   End Sub
End Module
' The example displays the following output:
'       File ≠ file
'       File = File
'       File ≠ FILE
'       File ≠ fıle

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
© 2016 Microsoft