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