英語で読む

次の方法で共有


Convert.ToSByte メソッド

定義

指定した値を 8 ビット符号付き整数に変換します。

オーバーロード

ToSByte(SByte)

指定した 8 ビット符号付き整数を返します。実際の変換は実行されません。

ToSByte(String, Int32)

指定した基数の数値の文字列形式を等価の 8 ビット符号付き整数に変換します。

ToSByte(String, IFormatProvider)

指定したカルチャ固有の書式情報を使用して、指定した数値の文字列形式を等価の 8 ビット符号付き整数に変換します。

ToSByte(Object, IFormatProvider)

指定したカルチャ固有の書式情報を使用して、指定したオブジェクトの値を 8 ビット符号付き整数に変換します。

ToSByte(UInt64)

指定した 64 ビット符号なし整数の値を等価の 8 ビット符号付き整数に変換します。

ToSByte(UInt32)

指定した 32 ビット符号なし整数の値を等価の 8 ビット符号付き整数に変換します。

ToSByte(String)

指定した数値の文字列形式を等価の 8 ビット符号付き整数に変換します。

ToSByte(Single)

指定した単精度浮動小数点数の値を等価の 8 ビット符号付き整数に変換します。

ToSByte(Object)

指定したオブジェクトの値を 8 ビット符号付き整数に変換します。

ToSByte(UInt16)

指定した 16 ビット符号なし整数の値を等価の 8 ビット符号付き整数に変換します。

ToSByte(Int32)

指定した 32 ビット符号付き整数の値を等価の 8 ビット符号付き整数に変換します。

ToSByte(Int64)

指定した 64 ビット符号付き整数の値を等価の 8 ビット符号付き整数に変換します。

ToSByte(Byte)

指定した 8 ビット符号なし整数の値を等価の 8 ビット符号付き整数に変換します。

ToSByte(Char)

指定した Unicode 文字の値を等価の 8 ビット符号付き整数に変換します。

ToSByte(DateTime)

このメソッドを呼び出すと、常に InvalidCastExceptionがスローされます。

ToSByte(Boolean)

指定したブール値を等価の 8 ビット符号付き整数に変換します。

ToSByte(Double)

指定した倍精度浮動小数点数の値を等価の 8 ビット符号付き整数に変換します。

ToSByte(Int16)

指定した 16 ビット符号付き整数の値を等価の 8 ビット符号付き整数に変換します。

ToSByte(Decimal)

指定した 10 進数の値を等価の 8 ビット符号付き整数に変換します。

ToSByte(SByte)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した 8 ビット符号付き整数を返します。実際の変換は実行されません。

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

パラメーター

value
SByte

返される 8 ビット符号付き整数。

戻り値

value は変更されずに返されます。

属性

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(String, Int32)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した基数の数値の文字列形式を等価の 8 ビット符号付き整数に変換します。

[System.CLSCompliant(false)]
public static sbyte ToSByte (string value, int fromBase);
[System.CLSCompliant(false)]
public static sbyte ToSByte (string? value, int fromBase);

パラメーター

value
String

変換する数値を含む文字列。

fromBase
Int32

value内の数値の底 。2、8、10、または 16 である必要があります。

戻り値

valueの数値に相当する 8 ビット符号付き整数。valuenull場合は 0 (ゼロ)。

属性

例外

fromBase が 2、8、10、または 16 ではありません。

-又は-

valueは、10 以外の符号付き番号を表し、先頭に負の符号が付きます。

valueEmptyです。

value には、fromBaseで指定されたベースに有効な数字以外の文字が含まれています。 例外メッセージは、value の最初の文字が無効な場合に変換する数字がないことを示します。それ以外の場合、メッセージは、value に無効な末尾の文字が含まれていることを示します。

valueは、10 以外の符号付き番号を表し、先頭に負の符号が付きます。

-又は-

は、SByte.MinValue より小さいか、SByte.MaxValueより大きい数値を表します。

次の例では、文字列配列内の要素を数値のバイナリ、8 進数、および 16 進数表現として解釈して、それらを符号なしバイトに変換しようとします。

using System;

public class Example
{
   public static void Main()
   {
      int[] baseValues = { 2, 8, 16};
      string[] values = { "FF", "81", "03", "11", "8F", "01", "1C", "111",
                          "123", "18A" };

      // Convert to each supported base.
      foreach (int baseValue in baseValues)
      {
         Console.WriteLine("Converting strings in base {0}:", baseValue);
         foreach (string value in values)
         {
            Console.Write("   '{0,-5}  -->  ", value + "'");
            try {
               Console.WriteLine(Convert.ToSByte(value, baseValue));
            }
            catch (FormatException) {
               Console.WriteLine("Bad Format");
            }
            catch (OverflowException) {
               Console.WriteLine("Out of Range");
            }
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       Converting strings in base 2:
//          'FF'    -->  Bad Format
//          '81'    -->  Bad Format
//          '03'    -->  Bad Format
//          '11'    -->  3
//          '8F'    -->  Bad Format
//          '01'    -->  1
//          '1C'    -->  Bad Format
//          '111'   -->  7
//          '123'   -->  Bad Format
//          '18A'   -->  Bad Format
//
//       Converting strings in base 8:
//          'FF'    -->  Bad Format
//          '81'    -->  Bad Format
//          '03'    -->  3
//          '11'    -->  9
//          '8F'    -->  Bad Format
//          '01'    -->  1
//          '1C'    -->  Bad Format
//          '111'   -->  73
//          '123'   -->  83
//          '18A'   -->  Bad Format
//
//       Converting strings in base 16:
//          'FF'    -->  -1
//          '81'    -->  -127
//          '03'    -->  3
//          '11'    -->  17
//          '8F'    -->  -113
//          '01'    -->  1
//          '1C'    -->  28
//          '111'   -->  Out of Range
//          '123'   -->  Out of Range
//          '18A'   -->  Out of Range

注釈

fromBase が 16 の場合は、value パラメーターで指定された数値の前に "0x" または "0X" を付けることができます。

負の符号は 10 以外の数値表現ではサポートされていないため、ToSByte(String, Int32) メソッドは負の数値が 2 の補数表現を使用することを前提としています。 つまり、メソッドは常にバイトの上位ビット (ビット 7) を符号ビットとして解釈します。 その結果、メソッドが例外をスローすることなく、SByte データ型の範囲外の 10 進数以外の値を SByte 値に変換するコードを記述できます。 次の例では、MaxValue を 16 進数の文字列形式に変換し、ToSByte(String, Int32) メソッドを呼び出します。 メソッドは、例外をスローする代わりに、"0xff -1 に変換します" というメッセージを表示します。

// Create a hexadecimal value out of range of the SByte type.
string value = Convert.ToString(byte.MaxValue, 16);
// Convert it back to a number.
try
{
   sbyte number = Convert.ToSByte(value, 16);
   Console.WriteLine("0x{0} converts to {1}.", value, number);
}
catch (OverflowException)
{
   Console.WriteLine("Unable to convert '0x{0}' to a signed byte.", value);
}

バイナリ演算または数値変換を実行する場合、メソッドが特定の値を解釈するために適切な数値表現を使用していることを確認するのは、常に開発者の責任です。 次の例に示すように、16 進数の文字列形式に変換するときに、最初に値が符号なし型と符号なし型のどちらを表すかを判断することで、メソッドが適切にオーバーフローを処理するようにすることができます。 元の値が符号なし型であったが、符号付きバイトへの変換によって符号ビットがオンになっている値が生成される場合は、例外をスローします。

// Create a hexadecimal value out of range of the SByte type.
byte sourceNumber = byte.MaxValue;
bool isSigned = Math.Sign(Convert.ToDouble(sourceNumber.GetType().GetField("MinValue").GetValue(null))) == -1;
string value = Convert.ToString(sourceNumber, 16);
sbyte targetNumber;
try
{
   targetNumber = Convert.ToSByte(value, 16);
   if (! isSigned && ((targetNumber & 0x80) != 0))
      throw new OverflowException();
   else
      Console.WriteLine("0x{0} converts to {1}.", value, targetNumber);
}
catch (OverflowException)
{
   Console.WriteLine("Unable to convert '0x{0}' to a signed byte.", value);
}
// Displays the following to the console:
//    Unable to convert '0xff' to a signed byte.

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(String, IFormatProvider)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定したカルチャ固有の書式情報を使用して、指定した数値の文字列形式を等価の 8 ビット符号付き整数に変換します。

[System.CLSCompliant(false)]
public static sbyte ToSByte (string value, IFormatProvider provider);
[System.CLSCompliant(false)]
public static sbyte ToSByte (string value, IFormatProvider? provider);

パラメーター

value
String

変換する数値を含む文字列。

provider
IFormatProvider

カルチャ固有の書式設定情報を提供するオブジェクト。

戻り値

valueに相当する 8 ビット符号付き整数。

属性

例外

valuenullです。

value は、省略可能な符号の後に数字のシーケンス (0 から 9) が続くものでは構成されません。

は、SByte.MinValue より小さいか、SByte.MaxValueより大きい数値を表します。

次の例では、IFormatProvider オブジェクトを使用して、SByte 値の文字列形式を ToSByte メソッドで変換します。

// Example of the Convert.ToSByte( string ) and
// Convert.ToSByte( string, IFormatProvider ) methods.
using System;
using System.Globalization;

class ToSByteProviderDemo
{
    static string format = "{0,-20}{1,-20}{2}";

     // Get the exception type name; remove the namespace prefix.
    static string GetExceptionType( Exception ex )
    {
        string exceptionType = ex.GetType( ).ToString( );
        return exceptionType.Substring(
            exceptionType.LastIndexOf( '.' ) + 1 );
    }

    static void ConvertToSByte( string numericStr,
        IFormatProvider provider )
    {
        object defaultValue;
        object providerValue;

        // Convert numericStr to SByte without a format provider.
        try
        {
            defaultValue = Convert.ToSByte( numericStr );
        }
        catch( Exception ex )
        {
            defaultValue = GetExceptionType( ex );
        }

        // Convert numericStr to SByte with a format provider.
        try
        {
            providerValue = Convert.ToSByte( numericStr, provider );
        }
        catch( Exception ex )
        {
            providerValue = GetExceptionType( ex );
        }

        Console.WriteLine( format, numericStr,
            defaultValue, providerValue );
    }

    public static void Main( )
    {
        // Create a NumberFormatInfo object and set several of its
        // properties that apply to numbers.
        NumberFormatInfo provider = new NumberFormatInfo();

        // These properties affect the conversion.
        provider.NegativeSign = "neg ";
        provider.PositiveSign = "pos ";

        // These properties do not affect the conversion.
        // The input string cannot have decimal and group separators.
        provider.NumberDecimalSeparator = ".";
        provider.NumberNegativePattern = 0;

        Console.WriteLine("This example of\n" +
            "  Convert.ToSByte( string ) and \n" +
            "  Convert.ToSByte( string, IFormatProvider ) " +
            "\ngenerates the following output. It converts " +
            "several strings to \nSByte values, using " +
            "default formatting or a NumberFormatInfo object.\n" );
        Console.WriteLine( format, "String to convert",
            "Default/exception", "Provider/exception" );
        Console.WriteLine( format, "-----------------",
            "-----------------", "------------------" );

        // Convert strings, with and without an IFormatProvider.
        ConvertToSByte( "123", provider );
        ConvertToSByte( "+123", provider );
        ConvertToSByte( "pos 123", provider );
        ConvertToSByte( "-123", provider );
        ConvertToSByte( "neg 123", provider );
        ConvertToSByte( "123.", provider );
        ConvertToSByte( "(123)", provider );
        ConvertToSByte( "128", provider );
        ConvertToSByte( "-129", provider );
    }
}

/*
This example of
  Convert.ToSByte( string ) and
  Convert.ToSByte( string, IFormatProvider )
generates the following output. It converts several strings to
SByte values, using default formatting or a NumberFormatInfo object.

String to convert   Default/exception   Provider/exception
-----------------   -----------------   ------------------
123                 123                 123
+123                123                 FormatException
pos 123             FormatException     123
-123                -123                FormatException
neg 123             FormatException     -123
123.                FormatException     FormatException
(123)               FormatException     FormatException
128                 OverflowException   OverflowException
-129                OverflowException   FormatException
*/

注釈

provider は、NumberFormatInfo オブジェクトを取得する IFormatProvider インスタンスです。 NumberFormatInfo オブジェクトは、valueの形式に関するカルチャ固有の情報を提供します。 providernullされている場合は、現在のカルチャの NumberFormatInfo が使用されます。

変換が失敗した場合に例外を処理しない場合は、代わりに SByte.TryParse メソッドを呼び出すことができます。 変換が成功したか失敗したかを示す Boolean 値が返されます。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(Object, IFormatProvider)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定したカルチャ固有の書式情報を使用して、指定したオブジェクトの値を 8 ビット符号付き整数に変換します。

[System.CLSCompliant(false)]
public static sbyte ToSByte (object value, IFormatProvider provider);
[System.CLSCompliant(false)]
public static sbyte ToSByte (object? value, IFormatProvider? provider);

パラメーター

value
Object

IConvertible インターフェイスを実装するオブジェクト。

provider
IFormatProvider

カルチャ固有の書式設定情報を提供するオブジェクト。

戻り値

valueに相当する 8 ビット符号付き整数。valuenull場合は 0。

属性

例外

value が適切な形式ではありません。

value では、IConvertible インターフェイスは実装されません。

-又は-

変換はサポートされていません。

は、SByte.MinValue より小さいか、SByte.MaxValueより大きい数値を表します。

次の例では、符号付きバイトと符号なしバイトの両方を 16 進文字列として格納する ByteString クラスと、バイトの符号を示すフィールドを定義します。 ByteString クラスは、IConvertible インターフェイスを実装します。 その IConvertible.ToSByte メソッドは、Parse(String, IFormatProvider) メソッドを呼び出して変換を実行します。 失敗した場合は、OverflowExceptionをスローします。

using System;
using System.Globalization;

public enum SignBit { Negative=-1, Zero=0, Positive=1 };

public struct ByteString : IConvertible
{
   private SignBit signBit;
   private string byteString;

   public SignBit Sign
   {
      set { signBit = value; }
      get { return signBit; }
   }

   public string Value
   {
      set {
         if (value.Trim().Length > 2)
            throw new ArgumentException("The string representation of a byte cannot have more than two characters.");
         else
            byteString = value;
      }
      get { return byteString; }
   }

   // IConvertible implementations.
   public TypeCode GetTypeCode() {
      return TypeCode.Object;
   }

   public bool ToBoolean(IFormatProvider provider)
   {
      if (signBit == SignBit.Zero)
         return false;
      else
         return true;
   }

   public byte ToByte(IFormatProvider provider)
   {
      if (signBit == SignBit.Negative)
         throw new OverflowException(String.Format("{0} is out of range of the Byte type.", Convert.ToSByte(byteString, 16)));
      else
         return Byte.Parse(byteString, NumberStyles.HexNumber);
   }

   public char ToChar(IFormatProvider provider)
   {
      if (signBit == SignBit.Negative) {
         throw new OverflowException(String.Format("{0} is out of range of the Char type.", Convert.ToSByte(byteString, 16)));
      }
      else {
         byte byteValue = Byte.Parse(this.byteString, NumberStyles.HexNumber);
         return Convert.ToChar(byteValue);
      }
   }

   public DateTime ToDateTime(IFormatProvider provider)
   {
      throw new InvalidCastException("ByteString to DateTime conversion is not supported.");
   }

   public decimal ToDecimal(IFormatProvider provider)
   {
      if (signBit == SignBit.Negative)
      {
         sbyte byteValue = SByte.Parse(byteString, NumberStyles.HexNumber);
         return Convert.ToDecimal(byteValue);
      }
      else
      {
         byte byteValue = Byte.Parse(byteString, NumberStyles.HexNumber);
         return Convert.ToDecimal(byteValue);
      }
   }

   public double ToDouble(IFormatProvider provider)
   {
      if (signBit == SignBit.Negative)
         return Convert.ToDouble(SByte.Parse(byteString, NumberStyles.HexNumber));
      else
         return Convert.ToDouble(Byte.Parse(byteString, NumberStyles.HexNumber));
   }

   public short ToInt16(IFormatProvider provider)
   {
      if (signBit == SignBit.Negative)
         return Convert.ToInt16(SByte.Parse(byteString, NumberStyles.HexNumber));
      else
         return Convert.ToInt16(Byte.Parse(byteString, NumberStyles.HexNumber));
   }

   public int ToInt32(IFormatProvider provider)
   {
      if (signBit == SignBit.Negative)
         return Convert.ToInt32(SByte.Parse(byteString, NumberStyles.HexNumber));
      else
         return Convert.ToInt32(Byte.Parse(byteString, NumberStyles.HexNumber));
   }

   public long ToInt64(IFormatProvider provider)
   {
      if (signBit == SignBit.Negative)
         return Convert.ToInt64(SByte.Parse(byteString, NumberStyles.HexNumber));
      else
         return Convert.ToInt64(Byte.Parse(byteString, NumberStyles.HexNumber));
   }

   public sbyte ToSByte(IFormatProvider provider)
   {
      try {
         return SByte.Parse(byteString, NumberStyles.HexNumber);
      }
      catch (OverflowException e) {
         throw new OverflowException(String.Format("{0} is outside the range of the SByte type.",
                                                   Byte.Parse(byteString, NumberStyles.HexNumber)), e);
      }
   }

   public float ToSingle(IFormatProvider provider)
   {
      if (signBit == SignBit.Negative)
         return Convert.ToSingle(SByte.Parse(byteString, NumberStyles.HexNumber));
      else
         return Convert.ToSingle(Byte.Parse(byteString, NumberStyles.HexNumber));
   }

   public string ToString(IFormatProvider provider)
   {
      return "0x" + this.byteString;
   }

   public object ToType(Type conversionType, IFormatProvider provider)
   {
      switch (Type.GetTypeCode(conversionType))
      {
         case TypeCode.Boolean:
            return this.ToBoolean(null);
         case TypeCode.Byte:
            return this.ToByte(null);
         case TypeCode.Char:
            return this.ToChar(null);
         case TypeCode.DateTime:
            return this.ToDateTime(null);
         case TypeCode.Decimal:
            return this.ToDecimal(null);
         case TypeCode.Double:
            return this.ToDouble(null);
         case TypeCode.Int16:
            return this.ToInt16(null);
         case TypeCode.Int32:
            return this.ToInt32(null);
         case TypeCode.Int64:
            return this.ToInt64(null);
         case TypeCode.Object:
            if (typeof(ByteString).Equals(conversionType))
               return this;
            else
               throw new InvalidCastException(String.Format("Conversion to a {0} is not supported.", conversionType.Name));
         case TypeCode.SByte:
            return this.ToSByte(null);
         case TypeCode.Single:
            return this.ToSingle(null);
         case TypeCode.String:
            return this.ToString(null);
         case TypeCode.UInt16:
            return this.ToUInt16(null);
         case TypeCode.UInt32:
            return this.ToUInt32(null);
         case TypeCode.UInt64:
            return this.ToUInt64(null);
         default:
            throw new InvalidCastException(String.Format("Conversion to {0} is not supported.", conversionType.Name));
      }
   }

   public UInt16 ToUInt16(IFormatProvider provider)
   {
      if (signBit == SignBit.Negative)
         throw new OverflowException(String.Format("{0} is outside the range of the UInt16 type.",
                                                   SByte.Parse(byteString, NumberStyles.HexNumber)));
      else
         return Convert.ToUInt16(Byte.Parse(byteString, NumberStyles.HexNumber));
   }

   public UInt32 ToUInt32(IFormatProvider provider)
   {
      if (signBit == SignBit.Negative)
         throw new OverflowException(String.Format("{0} is outside the range of the UInt32 type.",
                                                   SByte.Parse(byteString, NumberStyles.HexNumber)));
      else
         return Convert.ToUInt32(Byte.Parse(byteString, NumberStyles.HexNumber));
   }

   public UInt64 ToUInt64(IFormatProvider provider)
   {
      if (signBit == SignBit.Negative)
         throw new OverflowException(String.Format("{0} is outside the range of the UInt64 type.",
                                                   SByte.Parse(byteString, NumberStyles.HexNumber)));
      else
         return Convert.ToUInt64(Byte.Parse(byteString, NumberStyles.HexNumber));
   }
}

次の例は、ByteString クラスの IConvertible.ToSByte 実装が Convert.ToSByte(Object, IFormatProvider) メソッドによって呼び出される方法を示しています。

public class Class1
{
   public static void Main()
   {
      sbyte positiveByte = 120;
      sbyte negativeByte = -101;

      ByteString positiveString = new ByteString();
      positiveString.Sign = (SignBit) Math.Sign(positiveByte);
      positiveString.Value = positiveByte.ToString("X2");

      ByteString negativeString = new ByteString();
      negativeString.Sign = (SignBit) Math.Sign(negativeByte);
      negativeString.Value = negativeByte.ToString("X2");

      try {
         Console.WriteLine("'{0}' converts to {1}.", positiveString.Value, Convert.ToSByte(positiveString));
      }
      catch (OverflowException) {
         Console.WriteLine("0x{0} is outside the range of the Byte type.", positiveString.Value);
      }

      try {
         Console.WriteLine("'{0}' converts to {1}.", negativeString.Value, Convert.ToSByte(negativeString));
      }
      catch (OverflowException) {
         Console.WriteLine("0x{0} is outside the range of the Byte type.", negativeString.Value);
      }
   }
}
// The example displays the following output:
//       '78' converts to 120.
//       '9B' converts to -101.

注釈

provider を使用すると、ユーザーは valueの内容に関するカルチャ固有の変換情報を指定できます。 たとえば、value が数値を表す String である場合、provider は、その数値を表すために使用される表記に関するカルチャ固有の情報を提供できます。

基本型は providerを無視します。ただし、valueIConvertible インターフェイスを実装するユーザー定義型である場合は、パラメーターを使用できます。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(UInt64)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した 64 ビット符号なし整数の値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
UInt64

変換する 64 ビット符号なし整数。

戻り値

valueに相当する 8 ビット符号付き整数。

属性

例外

が SByte.MaxValue より大きいか、SByte.MinValue未満です。

次の例では、長整数の配列内の各要素を符号付きバイトに変換しようとします。

ulong[] numbers = { UInt64.MinValue, 121, 340, UInt64.MaxValue };
sbyte result;

foreach (ulong number in numbers)
{
   try {
      result = Convert.ToSByte(number);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the SByte type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    Converted the UInt64 value 0 to the SByte value 0.
//    Converted the UInt64 value 121 to the SByte value 121.
//    The UInt64 value 340 is outside the range of the SByte type.
//    The UInt64 value 18446744073709551615 is outside the range of the SByte type.

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(UInt32)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した 32 ビット符号なし整数の値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
UInt32

変換する 32 ビット符号なし整数。

戻り値

valueに相当する 8 ビット符号付き整数。

属性

例外

が SByte.MaxValue より大きいか、SByte.MinValue未満です。

次の例では、整数配列内の各要素を符号付きバイトに変換しようとしています。

uint[] numbers = { UInt32.MinValue, 121, 340, UInt32.MaxValue };
sbyte result;

foreach (uint number in numbers)
{
   try {
      result = Convert.ToSByte(number);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the SByte type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    Converted the UInt32 value 0 to the SByte value 0.
//    Converted the UInt32 value 121 to the SByte value 121.
//    The UInt32 value 340 is outside the range of the SByte type.
//    The UInt32 value 4294967295 is outside the range of the SByte type.

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(String)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した数値の文字列形式を等価の 8 ビット符号付き整数に変換します。

[System.CLSCompliant(false)]
public static sbyte ToSByte (string value);
[System.CLSCompliant(false)]
public static sbyte ToSByte (string? value);

パラメーター

value
String

変換する数値を含む文字列。

戻り値

valueの数値に相当する 8 ビット符号付き整数。値が null場合は 0 (ゼロ) です。

属性

例外

value は、省略可能な符号の後に数字のシーケンス (0 から 9) が続くものでは構成されません。

は、SByte.MinValue より小さいか、SByte.MaxValueより大きい数値を表します。

次の例では、既定の書式設定を使用して、ToSByte メソッドを使用して SByte 値の文字列形式を変換します。

// Example of the Convert.ToSByte( string ) and
// Convert.ToSByte( string, IFormatProvider ) methods.
using System;
using System.Globalization;

class ToSByteProviderDemo
{
    static string format = "{0,-20}{1,-20}{2}";

     // Get the exception type name; remove the namespace prefix.
    static string GetExceptionType( Exception ex )
    {
        string exceptionType = ex.GetType( ).ToString( );
        return exceptionType.Substring(
            exceptionType.LastIndexOf( '.' ) + 1 );
    }

    static void ConvertToSByte( string numericStr,
        IFormatProvider provider )
    {
        object defaultValue;
        object providerValue;

        // Convert numericStr to SByte without a format provider.
        try
        {
            defaultValue = Convert.ToSByte( numericStr );
        }
        catch( Exception ex )
        {
            defaultValue = GetExceptionType( ex );
        }

        // Convert numericStr to SByte with a format provider.
        try
        {
            providerValue = Convert.ToSByte( numericStr, provider );
        }
        catch( Exception ex )
        {
            providerValue = GetExceptionType( ex );
        }

        Console.WriteLine( format, numericStr,
            defaultValue, providerValue );
    }

    public static void Main( )
    {
        // Create a NumberFormatInfo object and set several of its
        // properties that apply to numbers.
        NumberFormatInfo provider = new NumberFormatInfo();

        // These properties affect the conversion.
        provider.NegativeSign = "neg ";
        provider.PositiveSign = "pos ";

        // These properties do not affect the conversion.
        // The input string cannot have decimal and group separators.
        provider.NumberDecimalSeparator = ".";
        provider.NumberNegativePattern = 0;

        Console.WriteLine("This example of\n" +
            "  Convert.ToSByte( string ) and \n" +
            "  Convert.ToSByte( string, IFormatProvider ) " +
            "\ngenerates the following output. It converts " +
            "several strings to \nSByte values, using " +
            "default formatting or a NumberFormatInfo object.\n" );
        Console.WriteLine( format, "String to convert",
            "Default/exception", "Provider/exception" );
        Console.WriteLine( format, "-----------------",
            "-----------------", "------------------" );

        // Convert strings, with and without an IFormatProvider.
        ConvertToSByte( "123", provider );
        ConvertToSByte( "+123", provider );
        ConvertToSByte( "pos 123", provider );
        ConvertToSByte( "-123", provider );
        ConvertToSByte( "neg 123", provider );
        ConvertToSByte( "123.", provider );
        ConvertToSByte( "(123)", provider );
        ConvertToSByte( "128", provider );
        ConvertToSByte( "-129", provider );
    }
}

/*
This example of
  Convert.ToSByte( string ) and
  Convert.ToSByte( string, IFormatProvider )
generates the following output. It converts several strings to
SByte values, using default formatting or a NumberFormatInfo object.

String to convert   Default/exception   Provider/exception
-----------------   -----------------   ------------------
123                 123                 123
+123                123                 FormatException
pos 123             FormatException     123
-123                -123                FormatException
neg 123             FormatException     -123
123.                FormatException     FormatException
(123)               FormatException     FormatException
128                 OverflowException   OverflowException
-129                OverflowException   FormatException
*/

注釈

ToSByte(String) メソッドの使用は、valueSByte.Parse(String) メソッドに渡すことと同じです。 value は、現在のカルチャの書式設定規則を使用して解釈されます。

変換が失敗した場合に例外を処理しない場合は、代わりに SByte.TryParse メソッドを呼び出すことができます。 変換が成功したか失敗したかを示す Boolean 値が返されます。

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(Single)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した単精度浮動小数点数の値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
Single

変換する単精度浮動小数点数。

戻り値

value、最も近い 8 ビット符号付き整数に丸められます。 value が 2 つの整数の中間にある場合は、偶数が返されます。つまり、4.5 は 4 に変換され、5.5 は 6 に変換されます。

属性

例外

が SByte.MaxValue より大きいか、SByte.MinValue未満です。

次の例では、Single 値の配列内の各要素を符号付きバイトに変換しようとします。

object[] values = { true, -12, 163, 935, 'x', "104", "103.0", "-1",
                    "1.00e2", "One", 1.00e2};
sbyte result;

foreach (object value in values)
{
   try {
      result = Convert.ToSByte(value);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        value.GetType().Name, value,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the SByte type.",
                        value.GetType().Name, value);
   }
   catch (FormatException) {
      Console.WriteLine("The {0} value {1} is not in a recognizable format.",
                        value.GetType().Name, value);
   }
   catch (InvalidCastException) {
      Console.WriteLine("No conversion to a Byte exists for the {0} value {1}.",
                        value.GetType().Name, value);
   }
}
// The example displays the following output:
//    Converted the Boolean value true to the SByte value 1.
//    Converted the Int32 value -12 to the SByte value -12.
//    The Int32 value 163 is outside the range of the SByte type.
//    The Int32 value 935 is outside the range of the SByte type.
//    Converted the Char value x to the SByte value 120.
//    Converted the String value 104 to the SByte value 104.
//    The String value 103.0 is not in a recognizable format.
//    Converted the String value -1 to the SByte value -1.
//    The String value 1.00e2 is not in a recognizable format.
//    The String value One is not in a recognizable format.
//    Converted the Double value 100 to the SByte value 100.

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(Object)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定したオブジェクトの値を 8 ビット符号付き整数に変換します。

[System.CLSCompliant(false)]
public static sbyte ToSByte (object value);
[System.CLSCompliant(false)]
public static sbyte ToSByte (object? value);

パラメーター

value
Object

IConvertible インターフェイスまたは nullを実装するオブジェクト。

戻り値

valueに相当する 8 ビット符号付き整数。valuenull場合は 0。

属性

例外

value が適切な形式ではありません。

value では、IConvertible インターフェイスは実装されません。

-又は-

変換はサポートされていません。

は、SByte.MinValue より小さいか、SByte.MaxValueより大きい数値を表します。

次の例では、オブジェクト配列内の各要素を符号付きバイトに変換しようとします。

object[] values = { true, -12, 163, 935, 'x', "104", "103.0", "-1",
                    "1.00e2", "One", 1.00e2};
sbyte result;

foreach (object value in values)
{
   try {
      result = Convert.ToSByte(value);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        value.GetType().Name, value,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the SByte type.",
                        value.GetType().Name, value);
   }
   catch (FormatException) {
      Console.WriteLine("The {0} value {1} is not in a recognizable format.",
                        value.GetType().Name, value);
   }
   catch (InvalidCastException) {
      Console.WriteLine("No conversion to a Byte exists for the {0} value {1}.",
                        value.GetType().Name, value);
   }
}
// The example displays the following output:
//    Converted the Boolean value true to the SByte value 1.
//    Converted the Int32 value -12 to the SByte value -12.
//    The Int32 value 163 is outside the range of the SByte type.
//    The Int32 value 935 is outside the range of the SByte type.
//    Converted the Char value x to the SByte value 120.
//    Converted the String value 104 to the SByte value 104.
//    The String value 103.0 is not in a recognizable format.
//    Converted the String value -1 to the SByte value -1.
//    The String value 1.00e2 is not in a recognizable format.
//    The String value One is not in a recognizable format.
//    Converted the Double value 100 to the SByte value 100.

注釈

戻り値は、基になる型の valueIConvertible.ToSByte メソッドを呼び出した結果です。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(UInt16)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した 16 ビット符号なし整数の値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
UInt16

変換する 16 ビット符号なし整数。

戻り値

valueに相当する 8 ビット符号付き整数。

属性

例外

が SByte.MaxValueより大きい。

次の例では、符号なし 16 ビット整数の配列内の各要素を符号付きバイトに変換しようとしています。

ushort[] numbers = { UInt16.MinValue, 121, 340, UInt16.MaxValue };
sbyte result;

foreach (ushort number in numbers)
{
   try {
      result = Convert.ToSByte(number);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the SByte type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    Converted the UInt16 value 0 to the SByte value 0.
//    Converted the UInt16 value 121 to the SByte value 121.
//    The UInt16 value 340 is outside the range of the SByte type.
//    The UInt16 value 65535 is outside the range of the SByte type.

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(Int32)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した 32 ビット符号付き整数の値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
Int32

変換する 32 ビット符号付き整数。

戻り値

valueに相当する 8 ビット符号付き整数。

属性

例外

が SByte.MaxValue より大きいか、SByte.MinValue未満です。

次の例では、符号付き整数の配列内の各要素を符号付きバイトに変換しようとします。

int[] numbers = { Int32.MinValue, -1, 0, 121, 340, Int32.MaxValue };
sbyte result;

foreach (int number in numbers)
{
   try {
      result = Convert.ToSByte(number);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the SByte type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    The Int32 value -2147483648 is outside the range of the SByte type.
//    Converted the Int32 value -1 to the SByte value -1.
//    Converted the Int32 value 0 to the SByte value 0.
//    Converted the Int32 value 121 to the SByte value 121.
//    The Int32 value 340 is outside the range of the SByte type.
//    The Int32 value 2147483647 is outside the range of the SByte type.

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(Int64)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した 64 ビット符号付き整数の値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
Int64

変換する 64 ビット符号付き整数。

戻り値

valueに相当する 8 ビット符号付き整数。

属性

例外

が SByte.MaxValue より大きいか、SByte.MinValue未満です。

次の例では、長整数の配列内の各要素を符号付きバイトに変換しようとします。

long[] numbers = { Int64.MinValue, -1, 0, 121, 340, Int64.MaxValue };
sbyte result;
foreach (long number in numbers)
{
   try {
      result = Convert.ToSByte(number);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the SByte type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    The Int64 value -9223372036854775808 is outside the range of the SByte type.
//    Converted the Int64 value -1 to the SByte value -1.
//    Converted the Int64 value 0 to the SByte value 0.
//    Converted the Int64 value 121 to the SByte value 121.
//    The Int64 value 340 is outside the range of the SByte type.
//    The Int64 value 9223372036854775807 is outside the range of the SByte type.

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(Byte)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した 8 ビット符号なし整数の値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
Byte

変換する 8 ビット符号なし整数。

戻り値

valueに相当する 8 ビット符号付き整数。

属性

例外

が SByte.MaxValueより大きい。

次の例では、バイト配列内の各要素を符号付きバイトに変換しようとします。

byte[] numbers = { Byte.MinValue, 10, 100, Byte.MaxValue };
sbyte result;

foreach (byte number in numbers)
{
   try {
      result = Convert.ToSByte(number);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the SByte type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    Converted the Byte value 0 to the SByte value 0.
//    Converted the Byte value 10 to the SByte value 10.
//    Converted the Byte value 100 to the SByte value 100.
//    The Byte value 255 is outside the range of the SByte type.

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(Char)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した Unicode 文字の値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
Char

変換する Unicode 文字。

戻り値

valueに相当する 8 ビット符号付き整数。

属性

例外

が SByte.MaxValueより大きい。

次の例では、Char 値の配列内の各要素を符号付きバイトに変換しようとします。

char[] chars = { 'a', 'z', '\u0007', '\u0200', '\u1023' };
foreach (char ch in chars)
{
   try {
      sbyte result = Convert.ToSByte(ch);
      Console.WriteLine("{0} is converted to {1}.", ch, result);
   }
   catch (OverflowException) {
      Console.WriteLine("Unable to convert u+{0} to a byte.",
                        Convert.ToInt16(ch).ToString("X4"));
   }
}
// The example displays the following output:
//    a is converted to 97.
//    z is converted to 122.
//     is converted to 7.
//    Unable to convert u+00C8 to a byte.
//    Unable to convert u+03FF to a byte.

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(DateTime)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

このメソッドを呼び出すと、常に InvalidCastExceptionがスローされます。

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

パラメーター

value
DateTime

変換する日付と時刻の値。

戻り値

この変換はサポートされていません。 値は返されません。

属性

例外

この変換はサポートされていません。

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ToSByte(Boolean)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定したブール値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
Boolean

変換するブール値。

戻り値

valuetrue場合の数値 1。それ以外の場合は 0。

属性

次の例では、ブール値 truefalse を符号付きバイト値に変換します。

bool falseFlag = false;
bool trueFlag = true;

Console.WriteLine("{0} converts to {1}.", falseFlag,
                  Convert.ToSByte(falseFlag));
Console.WriteLine("{0} converts to {1}.", trueFlag,
                  Convert.ToSByte(trueFlag));
// The example displays the following output:
//       false converts to 0.
//       true converts to 1.

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(Double)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した倍精度浮動小数点数の値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
Double

変換する倍精度浮動小数点数。

戻り値

value、最も近い 8 ビット符号付き整数に丸められます。 value が 2 つの整数の中間にある場合は、偶数が返されます。つまり、4.5 は 4 に変換され、5.5 は 6 に変換されます。

属性

例外

が SByte.MaxValue より大きいか、SByte.MinValue未満です。

次の例では、Double 値の配列内の各要素を符号付きバイトに変換しようとします。

double[] numbers = { Double.MinValue, -129.5, -12.7, 0, 16,
                     103.6, 255.0, 1.63509e17, Double.MaxValue};
sbyte result;

foreach (double number in numbers)
{
   try {
      result = Convert.ToSByte(number);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the SByte type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    The Double value -1.79769313486232E+308 is outside the range of the SByte type.
//    The Double value -129.5 is outside the range of the SByte type.
//    Converted the Double value -12.7 to the SByte value -13.
//    Converted the Double value 0 to the SByte value 0.
//    Converted the Double value 16 to the SByte value 16.
//    Converted the Double value 103.6 to the SByte value 104.
//    The Double value 255 is outside the range of the SByte type.
//    The Double value 1.63509E+17 is outside the range of the SByte type.
//    The Double value 1.79769313486232E+308 is outside the range of the SByte type.

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(Int16)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した 16 ビット符号付き整数の値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
Int16

変換する 16 ビット符号付き整数。

戻り値

valueに相当する 8 ビット符号付き整数。

属性

例外

が SByte.MaxValue より大きいか、SByte.MinValue未満です。

次の例では、符号付き 16 ビット整数の配列内の各要素を符号付きバイトに変換しようとしています。

short[] numbers = { Int16.MinValue, -1, 0, 121, 340, Int16.MaxValue };
sbyte result;
foreach (short number in numbers)
{
   try {
      result = Convert.ToSByte(number);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the SByte type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    The Int16 value -32768 is outside the range of the SByte type.
//    Converted the Int16 value -1 to the SByte value -1.
//    Converted the Int16 value 0 to the SByte value 0.
//    Converted the Int16 value 121 to the SByte value 121.
//    The Int16 value 340 is outside the range of the SByte type.
//    The Int16 value 32767 is outside the range of the SByte type.

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToSByte(Decimal)

ソース:
Convert.cs
ソース:
Convert.cs
ソース:
Convert.cs

重要

この API は CLS 準拠ではありません。

指定した 10 進数の値を等価の 8 ビット符号付き整数に変換します。

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

パラメーター

value
Decimal

変換する 10 進数。

戻り値

value、最も近い 8 ビット符号付き整数に丸められます。 value が 2 つの整数の中間にある場合は、偶数が返されます。つまり、4.5 は 4 に変換され、5.5 は 6 に変換されます。

属性

例外

が SByte.MaxValue より大きいか、SByte.MinValue未満です。

次の例では、Decimal 値の配列内の各要素を符号付きバイトに変換しようとします。

decimal[] numbers = { Decimal.MinValue, -129.5m, -12.7m, 0m, 16m,
                      103.6m, 255.0m, Decimal.MaxValue };
sbyte result;

foreach (decimal number in numbers)
{
   try {
      result = Convert.ToSByte(number);
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the SByte type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    The Decimal value -79228162514264337593543950335 is outside the range of the SByte type.
//    The Decimal value -129.5 is outside the range of the SByte type.
//    Converted the Decimal value -12.7 to the SByte value -13.
//    Converted the Decimal value 0 to the SByte value 0.
//    Converted the Decimal value 16 to the SByte value 16.
//    Converted the Decimal value 103.6 to the SByte value 104.
//    The Decimal value 255 is outside the range of the SByte type.
//    The Decimal value 79228162514264337593543950335 is outside the range of the SByte type.

こちらもご覧ください

適用対象

.NET 9 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0