StringEquals Method

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

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

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

public bool Equals(
	string value
virtual bool Equals(
	String^ value
) sealed
abstract Equals : 
        value:string -> bool
override Equals : 
        value:string -> bool
Public Function Equals (
	value As String
) As Boolean



The string to compare to this instance.

Return Value


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 method performs an ordinal comparison, only the comparison with an identical word returns true.

using System;

public class Example
   public static void Main()
      Console.OutputEncoding = System.Text.Encoding.UTF8;
      string word = "File";
      string[] others = { word.ToLower(), word, word.ToUpper(), "fıle" };
      foreach (string other in others)
         if (word.Equals(other)) 
            Console.WriteLine("{0} = {1}", word, other);
            Console.WriteLine("{0} {1} {2}", word, '\u2260', other);
// The example displays the following output:
//       File ≠ file
//       File = File
//       File ≠ FILE
//       File ≠ fıle
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