String.Equality Operator

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Determines whether two specified String objects have the same value.

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


Public Shared Operator = ( _
    a As String, _
    b As String _
) As Boolean
public static bool operator ==(
    string a,
    string b


  • a
    Type: System..::.String
    The first string to compare, or nullNothingnullptra null reference (Nothing in Visual Basic).
  • b
    Type: System..::.String
    The second string to compare, or nullNothingnullptra null reference (Nothing in Visual Basic).

Return Value

Type: System..::.Boolean
true if the value of a is the same as the value of b; otherwise, false.


The Equality method defines the operation of the equality operator for the String class.

This operator is implemented using the Equals method, which means the comparands are tested for a combination of reference and value equality. This operator performs an ordinal comparison.


The following code example demonstrates the equality operator.

// Example for the String Equality operator.
using System;

class Example
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
      outputBlock.Text +=
          "This example of the String Equality operator\n" +
          "generates the following output.\n" + "\n";

      CompareAndDisplay(outputBlock, "ijkl");
      CompareAndDisplay(outputBlock, "ABCD");
      CompareAndDisplay(outputBlock, "abcd");

   static void CompareAndDisplay(System.Windows.Controls.TextBlock outputBlock, string Comparand)
      String Lower = "abcd";

      outputBlock.Text += String.Format(
          "\"{0}\" == \"{1}\" ?  {2}",
          Lower, Comparand, Lower == Comparand) + "\n";

This example of the String Equality operator 
generates the following output.

"abcd" == "ijkl" ?  False
"abcd" == "ABCD" ?  False
"abcd" == "abcd" ?  True

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0


Windows Phone

See Also


String Class

System Namespace