String.Inequality 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 different values.

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

Syntax

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

Parameters

  • 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 different from the value of b; otherwise, false.

Remarks

The Inequality method defines the operation of the inequality 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.

Examples

The following code example demonstrates the inequality operator.

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

class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      outputBlock.Text +=
          "This example of the String Inequality 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 Inequality operator
generates the following output.

"abcd" != "ijkl" ?  True
"abcd" != "ABCD" ?  True
"abcd" != "abcd" ?  False
*/

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

String Class

System Namespace