Export (0) Print
Expand All

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 bool Equals(
	string value
)

Parameters

value
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.

Implements

IEquatable<T>.Equals(T)

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.

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);
         else
            Console.WriteLine("{0} {1} {2}", word, '\u2260', other);
      }        
   }
}
// The example displays the following output: 
//       File ≠ file 
//       File = File 
//       File ≠ FILE 
//       File ≠ fıle

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft