ToByte Method (String)

Convert.ToByte Method (String)

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

Converts the specified String representation of a number to an equivalent 8-bit unsigned integer.

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

public static byte ToByte(
	string value
)

Parameters

value
Type: System.String
A String containing a number to convert.

Return Value

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

ExceptionCondition
FormatException

value does not consist of an optional sign followed by a sequence of digits (zero through nine).

OverflowException

value represents a number less than MinValue or greater than MaxValue.

If you prefer not to handle an exception if the conversion fails, you can call the Byte.TryParse method instead. It returns a Boolean value that indicates whether the conversion succeeded or failed.

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