Export (0) Print
Expand All

Convert.ToByte Method (String)

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";
}


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

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

Community Additions

ADD
Show:
© 2014 Microsoft