Share via

  • Article

Byte.Equals Method (Byte)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Returns a value indicating whether this instance and a specified Byte object represent the same value.

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

Syntax

'Declaration
Public Function Equals ( _
    obj As Byte _
) As Boolean

public bool Equals(
    byte obj
)

Parameters

Return Value

Type: System.Boolean
true if obj is equal to this instance; otherwise, false.

Implements

IEquatable<T>.Equals(T)

Remarks

This method implements the System.IEquatable<T> interface, and performs slightly better than Equals(Object) because it does not have to convert the obj parameter to an object.

Examples

The following code example determines whether the first Byte value is equal to the second Byte value, and whether the first Byte value is equal to the boxed version of the second Byte value.

' This code example demonstrates the System.Byte.Equals(Object) and
' System.Byte.Equals(Byte) methods.


Class Example
   Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)
      Dim byteVal1 As Byte = &H7F
      Dim byteVal2 As Byte = 127
      Dim objectVal3 As Object = byteVal2
      '
      outputBlock.Text &= String.Format("byteVal1 = {0}, byteVal2 = {1}, objectVal3 = {2}" & vbCrLf, _
                        byteVal1, byteVal2, objectVal3) & vbCrLf
      outputBlock.Text &= String.Format("byteVal1 equals byteVal2?: {0}", byteVal1.Equals(byteVal2)) & vbCrLf
      outputBlock.Text &= String.Format("byteVal1 equals objectVal3?: {0}", byteVal1.Equals(objectVal3)) & vbCrLf
   End Sub 'Main
End Class 'Sample

'
'This code example produces the following results:
'
'byteVal1 = 127, byteVal2 = 127, objectVal3 = 127
'
'byteVal1 equals byteVal2?: True
'byteVal1 equals objectVal3?: True
'

// This code example demonstrates the System.Byte.Equals(Object) and
// System.Byte.Equals(Byte) methods.

using System;

class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      byte byteVal1 = 0x7f;
      byte byteVal2 = 127;
      object objectVal3 = byteVal2;
      //
      outputBlock.Text += String.Format("byteVal1 = {0}, byteVal2 = {1}, objectVal3 = {2}\n",
                         byteVal1, byteVal2, objectVal3) + "\n";
      outputBlock.Text += String.Format("byteVal1 equals byteVal2?: {0}", byteVal1.Equals(byteVal2)) + "\n";
      outputBlock.Text += String.Format("byteVal1 equals objectVal3?: {0}", byteVal1.Equals(objectVal3)) + "\n";
   }
}

/*
This code example produces the following results:

byteVal1 = 127, byteVal2 = 127, objectVal3 = 127

byteVal1 equals byteVal2?: True
byteVal1 equals objectVal3?: True

*/

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.