String.Equals Method (String, String)
.NET Framework (current version)
Determines whether two specified String objects have the same value.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- a
-
Type:
System.String
The first string to compare, or null.
- b
-
Type:
System.String
The second string to compare, or null.
Return Value
Type: System.Booleantrue if the value of a is the same as the value of b; otherwise, false. If both a and b are null, the method returns true.
This method performs an ordinal (case-sensitive and culture-insensitive) comparison.
The following example demonstrates the Equals method.
' Sample for String.Equals(Object) ' String.Equals(String) ' String.Equals(String, String) Imports System Imports System.Text Class Sample Public Shared Sub Main() Dim sb As New StringBuilder("abcd") Dim str1 As [String] = "abcd" Dim str2 As [String] = Nothing Dim o2 As [Object] = Nothing Console.WriteLine() Console.WriteLine(" * The value of String str1 is '{0}'.", str1) Console.WriteLine(" * The value of StringBuilder sb is '{0}'.", sb.ToString()) Console.WriteLine() Console.WriteLine("1a) String.Equals(Object). Object is a StringBuilder, not a String.") Console.WriteLine(" Is str1 equal to sb?: {0}", str1.Equals(sb)) Console.WriteLine() Console.WriteLine("1b) String.Equals(Object). Object is a String.") str2 = sb.ToString() o2 = str2 Console.WriteLine(" * The value of Object o2 is '{0}'.", o2) Console.WriteLine(" Is str1 equal to o2?: {0}", str1.Equals(o2)) Console.WriteLine() Console.WriteLine(" 2) String.Equals(String)") Console.WriteLine(" * The value of String str2 is '{0}'.", str2) Console.WriteLine(" Is str1 equal to str2?: {0}", str1.Equals(str2)) Console.WriteLine() Console.WriteLine(" 3) String.Equals(String, String)") Console.WriteLine(" Is str1 equal to str2?: {0}", [String].Equals(str1, str2)) End Sub 'Main End Class 'Sample ' 'This example produces the following results: ' ' * The value of String str1 is 'abcd'. ' * The value of StringBuilder sb is 'abcd'. ' '1a) String.Equals(Object). Object is a StringBuilder, not a String. ' Is str1 equal to sb?: False ' '1b) String.Equals(Object). Object is a String. ' * The value of Object o2 is 'abcd'. ' Is str1 equal to o2?: True ' ' 2) String.Equals(String) ' * The value of String str2 is 'abcd'. ' Is str1 equal to str2?: True ' ' 3) String.Equals(String, String) ' Is str1 equal to str2?: True '
Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Show: