Nullable(Of T).Equals Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Indicates whether the current Nullable(Of T) object is equal to a specified object.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- other
- Type: System.Object
An object.
Return Value
Type: System.Booleantrue if the other parameter is equal to the current Nullable(Of T) object; otherwise, false.
This table describes how equality is defined for the compared values:
Return Value | Description |
|---|---|
true | The HasValue property is false, and the other parameter is Nothing. That is, two null values are equal by definition. -or- The HasValue property is true, and the value returned by the Value property is equal to the other parameter. |
false | The HasValue property for the current Nullable(Of T) structure is true, and the other parameter is Nothing. -or- The HasValue property for the current Nullable(Of T) structure is false, and the other parameter is not Nothing. -or- The HasValue property for the current Nullable(Of T) structure is true, and the value returned by the Value property is not equal to the other parameter. |
If the HasValue property of the current Nullable(Of T) structure is true, equality is determined by passing the other parameter to the Equals method of the underlying value of the current Nullable(Of T) structure.
The following code example determines whether an object and a Nullable(Of T) object are equal to the current Nullable(Of T) object.
' This code example demonstrates the Nullable(Of T).Equals ' methods. Class Example Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock) Dim nullInt1 As Nullable(Of Integer) = 100 Dim nullInt2 As Nullable(Of Integer) = 200 Dim myObj As Object ' Determine if two nullable of System.Int32 values are equal. ' The nullable objects have different values. outputBlock.Text &= "1) nullInt1 and nullInt2 " If nullInt1.Equals(nullInt2) Then outputBlock.Text &= "are" Else outputBlock.Text &= "are not" End If outputBlock.Text &= " equal." & vbCrLf ' Determine if a nullable of System.Int32 and an object ' are equal. The object contains the boxed value of the ' nullable object. myObj = CType(nullInt1, Object) outputBlock.Text &= "2) nullInt1 and myObj " If nullInt1.Equals(myObj) Then outputBlock.Text &= "are" Else outputBlock.Text &= "are not" End If outputBlock.Text &= " equal." & vbCrLf End Sub 'Main End Class 'Sample ' 'This code example produces the following results: ' '1) nullInt1 and nullInt2 are not equal. '2) nullInt1 and myObj are equal. '