ToByte Method (Object)

Convert.ToByte Method (Object)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Converts the value of the specified Object to an 8-bit unsigned integer.

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

public static byte ToByte(
	Object value
)

Parameters

value
Type: System.Object
An Object that implements the IConvertible interface or null.

Return Value

Type: System.Byte
An 8-bit unsigned integer equivalent to the value of value, or zero if value is null.

ExceptionCondition
InvalidCastException

value does not implement IConvertible.

If value is not null, this method wraps a call to the IConvertible.ToByte implementation of the underlying type of value.

The following code sample illustrates the use of ToByte, converting a String value to a Byte :


public void ConvertStringByte(string stringVal)
{
   byte byteVal = 0;

   try
   {
      byteVal = System.Convert.ToByte(stringVal);
      outputBlock.Text += String.Format("{0} as a byte is: {1}",
         stringVal, byteVal) + "\n";
   }
   catch (System.OverflowException)
   {
      outputBlock.Text += String.Format(
         "Conversion from string to byte overflowed.") + "\n";
   }
   catch (System.FormatException)
   {
      outputBlock.Text += String.Format(
         "The string is not formatted as a byte.") + "\n";
   }
   catch (System.ArgumentNullException)
   {
      outputBlock.Text += String.Format(
         "The string is null.") + "\n";
   }

   //The conversion from byte to string is always valid.
   stringVal = System.Convert.ToString(byteVal);
   outputBlock.Text += String.Format("{0} as a string is {1}",
      byteVal, stringVal) + "\n";
}


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2017 Microsoft