指定した単精度浮動小数点数の値を等価の 8 ビット符号なし整数に変換します。
Overloads Public Shared Function ToByte( _
ByVal value As Single _) As Byte
[C#]
public static byte ToByte(floatvalue);
[C++]
public: static unsigned char ToByte(floatvalue);
[JScript]
public static function ToByte(
value : float) : Byte;
パラメータ
- value
単精度浮動小数点数。
戻り値
近似値の 8 ビット符号付き整数に丸められた value。value が 2 つの整数の中間にある場合は、偶数が返されます。たとえば、4.5 は 4 に変換され、5.5 は 6 に変換されます。
例外
例外の種類 | 条件 |
---|---|
OverflowException | value が Byte.MaxValue より大きい値か、 Byte.MinValue より小さい値です。 |
使用例
[Visual Basic, C#, C++] ToByte を使用して、 Single (float) の値を Byte に変換する方法については、次のコード例を参照してください。
Public Sub ConvertByteSingle(ByVal byteVal As Byte)
Dim singleVal As Single
' Byte to float conversion will not overflow.
singleVal = System.Convert.ToSingle(byteVal)
System.Console.WriteLine("The byte as a single is {0}.", _
singleVal)
' Single to byte conversion can overflow.
Try
byteVal = System.Convert.ToByte(singleVal)
System.Console.WriteLine("The single as a byte is {0}.", _
byteVal)
Catch exception As System.OverflowException
System.Console.WriteLine( _
"Overflow in single-to-byte conversion.")
End Try
End Sub
[C#]
public void ConvertByteSingle(byte byteVal) {
float floatVal;
// Byte to float conversion will not overflow.
floatVal = System.Convert.ToSingle(byteVal);
System.Console.WriteLine("The byte as a float is {0}.",
floatVal);
// Float to byte conversion can overflow.
try {
byteVal = System.Convert.ToByte(floatVal);
System.Console.WriteLine("The float as a byte is {0}.",
byteVal);
}
catch (System.OverflowException) {
System.Console.WriteLine(
"The float value is too large for a byte.");
}
}
[C++]
void ConvertByteSingle(Byte byteVal)
{
float floatVal;
// Byte to float conversion will not overflow.
floatVal = System::Convert::ToSingle(byteVal);
System::Console::WriteLine(S"The Byte as a float is {0}.",
__box(floatVal));
// Float to Byte conversion can overflow.
try {
byteVal = System::Convert::ToByte(floatVal);
System::Console::WriteLine(S"The float as a Byte is {0}.",
__box(byteVal));
} catch (System::OverflowException*) {
System::Console::WriteLine(S"The float value is too large for a Byte.");
}
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
参照
Convert クラス | Convert メンバ | System 名前空間 | Convert.ToByte オーバーロードの一覧