Export (0) Print
Expand All

String::Equality Operator

Determines whether two specified strings have the same value.

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

public:
static bool operator ==(
	String^ a, 
	String^ b
)

Parameters

a
Type: System::String

The first string to compare, or nullptr.

b
Type: System::String

The second string to compare, or nullptr.

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. The operator, in turn, calls the static Equals(String, String) method, which performs an ordinal (case-sensitive and culture-insensitive) comparison.

NoteNote

The Visual Basic compiler does not resolve the equality operator as a call to the Equality method. Instead, the equality operator wraps a call to the Operators::CompareString method.

The following example demonstrates the equality operator.

// Example for the String Equality operator. 
using namespace System;
void CompareAndDisplay( String^ Comparand )
{
   String^ Lower = "abcd";
   Console::WriteLine( "\"{0}\" == \"{1}\" ?  {2}", Lower, Comparand, Lower == Comparand );
}

int main()
{
   Console::WriteLine( "This example of the String Equality operator\n" 
   "generates the following output.\n" );
   CompareAndDisplay( "ijkl" );
   CompareAndDisplay( "ABCD" );
   CompareAndDisplay( "abcd" );
}

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

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

.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
Show:
© 2015 Microsoft