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
)
public static byte ToByte (
	String value
)
public static function ToByte (
	value : String
) : byte

Parameters

value

A String containing a number to convert.

Return Value

An 8-bit unsigned integer equivalent to the value of value. -or- Zero if value is a null reference (Nothing in Visual Basic).

Exception typeCondition

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.

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);
        System.Console.WriteLine("{0} as a byte is: {1}",
            stringVal, byteVal);
    } 
    catch (System.OverflowException) {
        System.Console.WriteLine(
            "Conversion from string to byte overflowed.");
    }
    catch (System.FormatException) {
        System.Console.WriteLine(
            "The string is not formatted as a byte.");
    }
    catch (System.ArgumentNullException) {
        System.Console.WriteLine(
            "The string is null.");
    }
    
    //The conversion from byte to string is always valid.
    stringVal = System.Convert.ToString(byteVal);
    System.Console.WriteLine("{0} as a string is {1}",
        byteVal, stringVal);
}

public void ConvertStringByte(String stringVal) 
{
    ubyte byteVal = 0;

    try {        
        byteVal = System.Convert.ToByte(stringVal);
        System.Console.WriteLine("{0} as a byte is: {1}", stringVal, 
            System.Convert.ToString(byteVal));
    }
    catch (System.OverflowException exp) {        
        System.Console.WriteLine(
            "Conversion from string to byte overflowed.");
    }
    catch (System.FormatException exp) {        
        System.Console.WriteLine("The string is not formatted as a byte.");
    }
    catch (System.ArgumentNullException exp) {        
        System.Console.WriteLine("The string is null.");
    }

    //The conversion from byte to string is always valid.
    stringVal = System.Convert.ToString(byteVal);
    System.Console.WriteLine("{0} as a string is {1}", 
        System.Convert.ToString(byteVal), stringVal);
} //ConvertStringByte

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft