System.Convert.ToSByte Method

Converts the value of the specified single-precision floating-point number to an equivalent 8-bit signed integer.

Syntax

[System.CLSCompliant(false)]
public static sbyte ToSByte (float value)

Parameters

value
The single-precision floating-point number to convert.

Returns

value, rounded to the nearest 8-bit signed integer. If value is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.

Exceptions

TypeReason
OverflowException value is greater than sbyte.MaxValue or less than sbyte.MinValue.

Remarks

Prior to the conversion, if value is halfway between two whole numbers, it is rounded to the nearest even integer. For example, 4.5 is rounded to 4, and 5.5 is rounded to 6.

This member is not CLS-compliant. For a CLS-compliant alternative, use Convert.ToInt16(object)(float).

Requirements

Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0