İngilizce dilinde oku

Aracılığıyla paylaş

Convert.ToInt16 Yöntem

  • Başvuru

Tanım

Ad Alanı:
System
Bütünleştirilmiş Kod:
System.Runtime.Extensions.dll
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Belirtilen değeri 16 bit işaretli tamsayıya dönüştürür.

Aşırı Yüklemeler

ToInt16(Single)

Belirtilen tek duyarlıklı kayan noktalı sayının değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.
ToInt16(String, IFormatProvider)

Bir sayının belirtilen dize gösterimini, belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak eşdeğer bir 16 bit imzalı tamsayıya dönüştürür.
ToInt16(Object, IFormatProvider)

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen nesnenin değerini 16 bit imzalı tamsayıya dönüştürür.
ToInt16(UInt64)

Belirtilen 64 bit işaretsiz tamsayı değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.
ToInt16(UInt32)

Belirtilen 32 bit işaretsiz tamsayı değerini eşdeğer bir 16 bit imzalı tamsayıya dönüştürür.
ToInt16(UInt16)

Belirtilen 16 bit işaretsiz tamsayı değerini eşdeğer 16 bit işaretli tamsayıya dönüştürür.
ToInt16(String)

Bir sayının belirtilen dize gösterimini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.
ToInt16(String, Int32)

Belirtilen tabandaki bir sayının dize gösterimini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.
ToInt16(SByte)

Belirtilen 8 bit işaretli tamsayı değerini eşdeğer 16 bit işaretli tamsayıya dönüştürür.
ToInt16(Int16)

Belirtilen 16 bit işaretli tamsayıyı döndürür; gerçek dönüştürme gerçekleştirilmemesi.
ToInt16(Int64)

Belirtilen 64 bit işaretli tamsayı değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.
ToInt16(Int32)

Belirtilen 32 bit işaretli tamsayı değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.
ToInt16(Double)

Belirtilen çift duyarlıklı kayan nokta sayısının değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.
ToInt16(Decimal)

Belirtilen ondalık sayının değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.
ToInt16(DateTime)

Bu yöntemin çağrılması her zaman oluşturur InvalidCastException.
ToInt16(Char)

Belirtilen Unicode karakterinin değerini eşdeğer 16 bit işaretli tamsayıya dönüştürür.
ToInt16(Byte)

Belirtilen 8 bit işaretsiz tamsayı değerini eşdeğer 16 bit işaretli tamsayıya dönüştürür.
ToInt16(Boolean)

Belirtilen Boole değerini eşdeğer 16 bit işaretli tamsayıya dönüştürür.
ToInt16(Object)

Belirtilen nesnenin değerini 16 bit imzalı tamsayıya dönüştürür.

ToInt16(Single)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen tek duyarlıklı kayan noktalı sayının değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.

public static short ToInt16 (float value);

Parametreler

value
Single

Dönüştürülecek tek duyarlıklı kayan nokta sayısı.

Döndürülenler

Int16

value, en yakın 16 bit işaretli tamsayıya yuvarlanmış. İki tamsayının ortasındaysa value çift sayı döndürülür; yani 4,5 4'e, 5,5 ise 6'ya dönüştürülür.

Özel durumlar

OverflowException

value Int16.MaxValue değerinden büyük veya Int16.MinValue değerinden küçüktür.

Örnekler

Aşağıdaki örnek, bir değer dizisindeki Single her öğeyi 16 bit imzalı bir tamsayıya dönüştürmeyi dener.

float[] values = { Single.MinValue, -1.38e10f, -1023.299f, -12.98f,
                   0f, 9.113e-16f, 103.919f, 17834.191f, Single.MaxValue };
short result;

foreach (float value in values)
{
   try {
      result = Convert.ToInt16(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("{0} is outside the range of the Int16 type.", value);
   }
}
// The example displays the following output:
//    -3.4028235E+38 is outside the range of the Int16 type.
//    -1.38E+10 is outside the range of the Int16 type.
//    Converted the Single value -1023.299 to the Int16 value -1023.
//    Converted the Single value -12.98 to the Int16 value -13.
//    Converted the Single value 0 to the Int16 value 0.
//    Converted the Single value 9.113E-16 to the Int16 value 0.
//    Converted the Single value 103.919 to the Int16 value 104.
//    Converted the Single value 17834.191 to the Int16 value 17834.
//    3.4028235E+38 is outside the range of the Int16 type.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(String, IFormatProvider)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Bir sayının belirtilen dize gösterimini, belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak eşdeğer bir 16 bit imzalı tamsayıya dönüştürür.

public static short ToInt16 (string value, IFormatProvider provider);
public static short ToInt16 (string? value, IFormatProvider? provider);

Parametreler

value
String

Dönüştürülecek sayıyı içeren bir dize.

provider
IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan nesne.

Döndürülenler

Int16

içindeki sayıya valueeşdeğer 16 bit işaretli bir tamsayı veya ise value 0 (sıfır) olur null.

Özel durumlar

FormatException

value , isteğe bağlı bir işaretin ardından bir basamak dizisi (0 ile 9 arasında) arasında bir işaretten oluşmaz.

OverflowException

value Int16.MinValue değerinden küçük veya Int16.MaxValue değerinden büyük bir sayıyı temsil eder.

Örnekler

Aşağıdaki örnek, 16 bit tamsayıların dize gösterimlerini bir IFormatProvider nesnesi kullanarak yöntemiyle ToInt16 dönüştürür.

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

class ToInt16ProviderDemo
{
    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 ConvertToInt16( string numericStr,
        IFormatProvider provider )
    {
        object defaultValue;
        object providerValue;

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

        // Convert numericStr to Int16 with a format provider.
        try
        {
            providerValue = Convert.ToInt16( 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.NumberGroupSeparator = ",";
        provider.NumberGroupSizes = new int[ ] { 3 };
        provider.NumberNegativePattern = 0;

        Console.WriteLine("This example of\n" +
            "  Convert.ToInt16( string ) and \n" +
            "  Convert.ToInt16( string, IFormatProvider ) " +
            "\ngenerates the following output. It converts " +
            "several strings to \nshort 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.
        ConvertToInt16( "12345", provider );
        ConvertToInt16( "+12345", provider );
        ConvertToInt16( "pos 12345", provider );
        ConvertToInt16( "-12345", provider );
        ConvertToInt16( "neg 12345", provider );
        ConvertToInt16( "12345.", provider );
        ConvertToInt16( "12,345", provider );
        ConvertToInt16( "(12345)", provider );
        ConvertToInt16( "32768", provider );
        ConvertToInt16( "-32769", provider );
    }
}

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

String to convert   Default/exception   Provider/exception
-----------------   -----------------   ------------------
12345               12345               12345
+12345              12345               FormatException
pos 12345           FormatException     12345
-12345              -12345              FormatException
neg 12345           FormatException     -12345
12345.              FormatException     FormatException
12,345              FormatException     FormatException
(12345)             FormatException     FormatException
32768               OverflowException   OverflowException
-32769              OverflowException   FormatException
*/

Açıklamalar

provider bir nesnesi edinen bir IFormatProviderNumberFormatInfo örnektir. NumberFormatInfo nesnesi, biçimi valuehakkında kültüre özgü bilgiler sağlar. ise providernull, NumberFormatInfo geçerli kültür için kullanılır.

Dönüştürme başarısız olursa bir özel durumu işlemeyi tercih ederseniz, bunun yerine yöntemini çağırabilirsiniz Int16.TryParse . Dönüştürmenin başarılı mı yoksa başarısız mı olduğunu gösteren bir Boolean değer döndürür.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(Object, IFormatProvider)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen nesnenin değerini 16 bit imzalı tamsayıya dönüştürür.

public static short ToInt16 (object value, IFormatProvider provider);
public static short ToInt16 (object? value, IFormatProvider? provider);

Parametreler

value
Object

Arabirimini uygulayan IConvertible bir nesne.

provider
IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan nesne.

Döndürülenler

Int16

ile eşdeğer valuebir 16 bit işaretli tamsayı veya ise value sıfır.null

Özel durumlar

FormatException

value türü için Int16 uygun bir biçimde değil.

InvalidCastException

value uygulamaz IConvertible.

OverflowException

value Int16.MinValue değerinden küçük veya Int16.MaxValue değerinden büyük bir sayıyı temsil eder.

Örnekler

Aşağıdaki örnek uygulayan IConvertible bir sınıfı ve uygulayan IFormatProviderbir sınıfı tanımlar. uygulayan IConvertible sınıfın nesneleri bir değer dizisini Double tutar. Her sınıfın nesnesi yöntemine ToInt16 geçirilir. Bu yöntem, ortalamanın nasıl hesaplandığını belirlemek için uygulanan IFormatProvider nesnesini kullanarak değer dizisinin Double ortalamasını döndürür.

using System;
using System.Collections;

// Define the types of averaging available in the class
// implementing IConvertible.
public enum AverageType : short
{
    None = 0,
    GeometricMean = 1,
    ArithmeticMean = 2,
    Median = 3
};

// Pass an instance of this class to methods that require an
// IFormatProvider. The class instance determines the type of
// average to calculate.
public class AverageInfo : IFormatProvider
{
    protected AverageType AvgType;

    // Specify the type of averaging in the constructor.
    public AverageInfo( AverageType avgType )
    {
        this.AvgType = avgType;
    }

    // This method returns a reference to the containing object
    // if an object of AverageInfo type is requested.
    public object GetFormat( Type argType )
    {
        if ( argType == typeof( AverageInfo ) )
            return this;
        else
            return null;
    }

    // Use this property to set or get the type of averaging.
    public AverageType TypeOfAverage
    {
        get { return this.AvgType; }
        set { this.AvgType = value; }
    }
}

// This class encapsulates an array of double values and implements
// the IConvertible interface. Most of the IConvertible methods
// return an average of the array elements in one of three types:
// arithmetic mean, geometric mean, or median.
public class DataSet : IConvertible
{
    protected ArrayList     data;
    protected AverageInfo   defaultProvider;

    // Construct the object and add an initial list of values.
    // Create a default format provider.
    public DataSet( params double[ ] values )
    {
        data = new ArrayList( values );
        defaultProvider =
            new AverageInfo( AverageType.ArithmeticMean );
    }

    // Add additional values with this method.
    public int Add( double value )
    {
        data.Add( value );
        return data.Count;
    }

    // Get, set, and add values with this indexer property.
    public double this[ int index ]
    {
        get
        {
            if( index >= 0 && index < data.Count )
                return (double)data[ index ];
            else
                throw new InvalidOperationException(
                    "[DataSet.get] Index out of range." );
        }
        set
        {
            if( index >= 0 && index < data.Count )
                data[ index ] = value;

            else if( index == data.Count )
                data.Add( value );
            else
                throw new InvalidOperationException(
                    "[DataSet.set] Index out of range." );
        }
    }

    // This property returns the number of elements in the object.
    public int Count
    {
        get { return data.Count; }
    }

    // This method calculates the average of the object's elements.
    protected double Average( AverageType avgType )
    {
        double  SumProd;

        if( data.Count == 0 )
            return 0.0;

        switch( avgType )
        {
            case AverageType.GeometricMean:

                SumProd = 1.0;
                for( int Index = 0; Index < data.Count; Index++ )
                    SumProd *= (double)data[ Index ];

                // This calculation will not fail with negative
                // elements.
                return Math.Sign( SumProd ) * Math.Pow(
                    Math.Abs( SumProd ), 1.0 / data.Count );

            case AverageType.ArithmeticMean:

                SumProd = 0.0;
                for( int Index = 0; Index < data.Count; Index++ )
                    SumProd += (double)data[ Index ];

                return SumProd / data.Count;

            case AverageType.Median:

                if( data.Count % 2 == 0 )
                    return ( (double)data[ data.Count / 2 ] +
                        (double)data[ data.Count / 2 - 1 ] ) / 2.0;
                else
                    return (double)data[ data.Count / 2 ];

            default:
                return 0.0;
        }
    }

    // Get the AverageInfo object from the caller's format provider,
    // or use the local default.
    protected AverageInfo GetAverageInfo( IFormatProvider provider )
    {
        AverageInfo avgInfo = null;

        if( provider != null )
            avgInfo = (AverageInfo)provider.GetFormat(
                typeof( AverageInfo ) );

        if ( avgInfo == null )
            return defaultProvider;
        else
            return avgInfo;
    }

    // Calculate the average and limit the range.
    protected double CalcNLimitAverage( double min, double max,
        IFormatProvider provider )
    {
        // Get the format provider and calculate the average.
        AverageInfo avgInfo = GetAverageInfo( provider );
        double avg = Average( avgInfo.TypeOfAverage );

        // Limit the range, based on the minimum and maximum values
        // for the type.
        return avg > max ? max : avg < min ? min : avg;
    }

    // The following elements are required by IConvertible.

    // None of these conversion functions throw exceptions. When
    // the data is out of range for the type, the appropriate
    // MinValue or MaxValue is used.
    public TypeCode GetTypeCode( )
    {
        return TypeCode.Object;
    }

    public bool ToBoolean( IFormatProvider provider )
    {
        // ToBoolean is false if the dataset is empty.
        if( data.Count <= 0 )
        {
            return false;
        }

        // For median averaging, ToBoolean is true if any
        // non-discarded elements are nonzero.
        else if( AverageType.Median ==
            GetAverageInfo( provider ).TypeOfAverage )
        {
            if (data.Count % 2 == 0 )
                return ( (double)data[ data.Count / 2 ] != 0.0 ||
                    (double)data[ data.Count / 2 - 1 ] != 0.0 );
            else
                return (double)data[ data.Count / 2 ] != 0.0;
        }

        // For arithmetic or geometric mean averaging, ToBoolean is
        // true if any element of the dataset is nonzero.
        else
        {
            for( int Index = 0; Index < data.Count; Index++ )
                if( (double)data[ Index ] != 0.0 )
                    return true;
            return false;
        }
    }

    public byte ToByte( IFormatProvider provider )
    {
        return Convert.ToByte( CalcNLimitAverage(
            Byte.MinValue, Byte.MaxValue, provider ) );
    }

    public char ToChar( IFormatProvider provider )
    {
        return Convert.ToChar( Convert.ToUInt16( CalcNLimitAverage(
            Char.MinValue, Char.MaxValue, provider ) ) );
    }

    // Convert to DateTime by adding the calculated average as
    // seconds to the current date and time. A valid DateTime is
    // always returned.
    public DateTime ToDateTime( IFormatProvider provider )
    {
        double seconds =
            Average( GetAverageInfo( provider ).TypeOfAverage );
        try
        {
            return DateTime.Now.AddSeconds( seconds );
        }
        catch( ArgumentOutOfRangeException )
        {
            return seconds < 0.0 ? DateTime.MinValue : DateTime.MaxValue;
        }
    }

    public decimal ToDecimal( IFormatProvider provider )
    {
        // The Double conversion rounds Decimal.MinValue and
        // Decimal.MaxValue to invalid Decimal values, so the
        // following limits must be used.
        return Convert.ToDecimal( CalcNLimitAverage(
            -79228162514264330000000000000.0,
            79228162514264330000000000000.0, provider ) );
    }

    public double ToDouble( IFormatProvider provider )
    {
        return Average( GetAverageInfo(provider).TypeOfAverage );
    }

    public short ToInt16( IFormatProvider provider )
    {
        return Convert.ToInt16( CalcNLimitAverage(
            Int16.MinValue, Int16.MaxValue, provider ) );
    }

    public int ToInt32( IFormatProvider provider )
    {
        return Convert.ToInt32( CalcNLimitAverage(
            Int32.MinValue, Int32.MaxValue, provider ) );
    }

    public long ToInt64( IFormatProvider provider )
    {
        // The Double conversion rounds Int64.MinValue and
        // Int64.MaxValue to invalid Int64 values, so the following
        // limits must be used.
        return Convert.ToInt64( CalcNLimitAverage(
            -9223372036854775000, 9223372036854775000, provider ) );
    }

    public SByte ToSByte( IFormatProvider provider )
    {
        return Convert.ToSByte( CalcNLimitAverage(
            SByte.MinValue, SByte.MaxValue, provider ) );
    }

    public float ToSingle( IFormatProvider provider )
    {
        return Convert.ToSingle( CalcNLimitAverage(
            Single.MinValue, Single.MaxValue, provider ) );
    }

    public UInt16 ToUInt16( IFormatProvider provider )
    {
        return Convert.ToUInt16( CalcNLimitAverage(
            UInt16.MinValue, UInt16.MaxValue, provider ) );
    }

    public UInt32 ToUInt32( IFormatProvider provider )
    {
        return Convert.ToUInt32( CalcNLimitAverage(
            UInt32.MinValue, UInt32.MaxValue, provider ) );
    }

    public UInt64 ToUInt64( IFormatProvider provider )
    {
        // The Double conversion rounds UInt64.MaxValue to an invalid
        // UInt64 value, so the following limit must be used.
        return Convert.ToUInt64( CalcNLimitAverage(
            0, 18446744073709550000.0, provider ) );
    }

    public object ToType( Type conversionType,
        IFormatProvider provider )
    {
        return Convert.ChangeType( Average(
            GetAverageInfo( provider ).TypeOfAverage ),
            conversionType );
    }

    public string ToString( IFormatProvider provider )
    {
        AverageType avgType = GetAverageInfo( provider ).TypeOfAverage;
        return String.Format( "( {0}: {1:G10} )", avgType,
            Average( avgType ) );
    }
}

class IConvertibleProviderDemo
{
    // Display a DataSet with three different format providers.
    public static void DisplayDataSet( DataSet ds )
    {
        string      fmt    = "{0,-12}{1,20}{2,20}{3,20}";
        AverageInfo median = new AverageInfo( AverageType.Median );
        AverageInfo geMean =
            new AverageInfo( AverageType.GeometricMean );

         // Display the dataset elements.
        if( ds.Count > 0 )
        {
            Console.Write( "\nDataSet: [{0}", ds[ 0 ] );
            for( int iX = 1; iX < ds.Count; iX++ )
                Console.Write( ", {0}", ds[ iX ] );
            Console.WriteLine( "]\n" );
        }

        Console.WriteLine( fmt, "Convert.", "Default",
            "Geometric Mean", "Median");
        Console.WriteLine( fmt, "--------", "-------",
            "--------------", "------");
        Console.WriteLine( fmt, "ToBoolean",
            Convert.ToBoolean( ds, null ),
            Convert.ToBoolean( ds, geMean ),
            Convert.ToBoolean( ds, median ) );
        Console.WriteLine( fmt, "ToByte",
            Convert.ToByte( ds, null ),
            Convert.ToByte( ds, geMean ),
            Convert.ToByte( ds, median ) );
        Console.WriteLine( fmt, "ToChar",
            Convert.ToChar( ds, null ),
            Convert.ToChar( ds, geMean ),
            Convert.ToChar( ds, median ) );
        Console.WriteLine( "{0,-12}{1,20:yyyy-MM-dd HH:mm:ss}" +
            "{2,20:yyyy-MM-dd HH:mm:ss}{3,20:yyyy-MM-dd HH:mm:ss}",
            "ToDateTime", Convert.ToDateTime( ds, null ),
            Convert.ToDateTime( ds, geMean ),
            Convert.ToDateTime( ds, median ) );
        Console.WriteLine( fmt, "ToDecimal",
            Convert.ToDecimal( ds, null ),
            Convert.ToDecimal( ds, geMean ),
            Convert.ToDecimal( ds, median ) );
        Console.WriteLine( fmt, "ToDouble",
            Convert.ToDouble( ds, null ),
            Convert.ToDouble( ds, geMean ),
            Convert.ToDouble( ds, median ) );
        Console.WriteLine( fmt, "ToInt16",
            Convert.ToInt16( ds, null ),
            Convert.ToInt16( ds, geMean ),
            Convert.ToInt16( ds, median ) );
        Console.WriteLine( fmt, "ToInt32",
            Convert.ToInt32( ds, null ),
            Convert.ToInt32( ds, geMean ),
            Convert.ToInt32( ds, median ) );
        Console.WriteLine( fmt, "ToInt64",
            Convert.ToInt64( ds, null ),
            Convert.ToInt64( ds, geMean ),
            Convert.ToInt64( ds, median ) );
        Console.WriteLine( fmt, "ToSByte",
            Convert.ToSByte( ds, null ),
            Convert.ToSByte( ds, geMean ),
            Convert.ToSByte( ds, median ) );
        Console.WriteLine( fmt, "ToSingle",
            Convert.ToSingle( ds, null ),
            Convert.ToSingle( ds, geMean ),
            Convert.ToSingle( ds, median ) );
        Console.WriteLine( fmt, "ToUInt16",
            Convert.ToUInt16( ds, null ),
            Convert.ToUInt16( ds, geMean ),
            Convert.ToUInt16( ds, median ) );
        Console.WriteLine( fmt, "ToUInt32",
            Convert.ToUInt32( ds, null ),
            Convert.ToUInt32( ds, geMean ),
            Convert.ToUInt32( ds, median ) );
        Console.WriteLine( fmt, "ToUInt64",
            Convert.ToUInt64( ds, null ),
            Convert.ToUInt64( ds, geMean ),
            Convert.ToUInt64( ds, median ) );
    }

    public static void Main( )
    {
        Console.WriteLine( "This example of " +
            "the Convert.To<Type>( object, IFormatProvider ) methods " +
            "\ngenerates the following output. The example " +
            "displays the values \nreturned by the methods, " +
            "using several IFormatProvider objects.\n" );

        DataSet ds1 = new DataSet(
            10.5, 22.2, 45.9, 88.7, 156.05, 297.6 );
        DisplayDataSet( ds1 );

        DataSet ds2 = new DataSet(
            359999.95, 425000, 499999.5, 775000, 1695000 );
        DisplayDataSet( ds2 );
    }
}

/*
This example of the Convert.To<Type>( object, IFormatProvider ) methods
generates the following output. The example displays the values
returned by the methods, using several IFormatProvider objects.

DataSet: [10.5, 22.2, 45.9, 88.7, 156.05, 297.6]

Convert.                 Default      Geometric Mean              Median
--------                 -------      --------------              ------
ToBoolean                   True                True                True
ToByte                       103                  59                  67
ToChar                         g                   ;                   C
ToDateTime   2003-05-13 15:04:12 2003-05-13 15:03:28 2003-05-13 15:03:35
ToDecimal       103.491666666667    59.4332135445164                67.3
ToDouble        103.491666666667    59.4332135445164                67.3
ToInt16                      103                  59                  67
ToInt32                      103                  59                  67
ToInt64                      103                  59                  67
ToSByte                      103                  59                  67
ToSingle                103.4917            59.43321                67.3
ToUInt16                     103                  59                  67
ToUInt32                     103                  59                  67
ToUInt64                     103                  59                  67

DataSet: [359999.95, 425000, 499999.5, 775000, 1695000]

Convert.                 Default      Geometric Mean              Median
--------                 -------      --------------              ------
ToBoolean                   True                True                True
ToByte                       255                 255                 255
ToChar                         ?                   ?                   ?
ToDateTime   2003-05-22 07:39:08 2003-05-20 22:28:45 2003-05-19 09:55:48
ToDecimal              750999.89    631577.237188435            499999.5
ToDouble               750999.89    631577.237188435            499999.5
ToInt16                    32767               32767               32767
ToInt32                   751000              631577              500000
ToInt64                   751000              631577              500000
ToSByte                      127                 127                 127
ToSingle                750999.9            631577.3            499999.5
ToUInt16                   65535               65535               65535
ToUInt32                  751000              631577              500000
ToUInt64                  751000              631577              500000
*/

Açıklamalar

provider kullanıcının içeriği hakkında kültüre özgü dönüştürme bilgilerini belirtmesini valuesağlar. Örneğin, bir sayıyı temsil eden bir String isevalue, provider bu sayıyı temsil etmek için kullanılan gösterimi hakkında kültüre özgü bilgiler sağlayabilir.

Temel türler yoksayarprovider; ancak arabirimini uygulayan IConvertible kullanıcı tanımlı bir türse value parametresi kullanılabilir.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(UInt64)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 64 bit işaretsiz tamsayı değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.

[System.CLSCompliant(false)]
public static short ToInt16 (ulong value);

Parametreler

value
UInt64

Dönüştürülecek 64 bit işaretsiz tamsayı.

Döndürülenler

Int16

ile eşdeğer value16 bit işaretli bir tamsayı.

Öznitelikler
CLSCompliantAttribute

Özel durumlar

OverflowException

value Int16.MaxValue değerinden büyüktür.

Örnekler

Aşağıdaki örnek, işaretsiz uzun tamsayı dizisindeki her öğeyi 16 bit imzalı tamsayıya dönüştürmeyi dener.

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

foreach (ulong number in numbers)
{
   try {
      result = Convert.ToInt16(number);
      Console.WriteLine("Converted the {0} value {1} to a {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 Int16 type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    Converted the UInt64 value 0 to a Int16 value 0.
//    Converted the UInt64 value 121 to a Int16 value 121.
//    Converted the UInt64 value 340 to a Int16 value 340.
//    The UInt64 value 18446744073709551615 is outside the range of the Int16 type.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(UInt32)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 32 bit işaretsiz tamsayı değerini eşdeğer bir 16 bit imzalı tamsayıya dönüştürür.

[System.CLSCompliant(false)]
public static short ToInt16 (uint value);

Parametreler

value
UInt32

Dönüştürülecek 32 bit işaretsiz tamsayı.

Döndürülenler

Int16

ile eşdeğer value16 bit işaretli bir tamsayı.

Öznitelikler
CLSCompliantAttribute

Özel durumlar

OverflowException

value Int16.MaxValue değerinden büyüktür.

Örnekler

Aşağıdaki örnek, işaretsiz tamsayı dizisindeki her öğeyi 16 bit imzalı tamsayıya dönüştürmeyi dener.

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

foreach (uint number in numbers)
{
   try {
      result = Convert.ToInt16(number);
      Console.WriteLine("Converted the {0} value {1} to a {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 Int16 type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    Converted the UInt32 value 0 to a Int16 value 0.
//    Converted the UInt32 value 121 to a Int16 value 121.
//    Converted the UInt32 value 340 to a Int16 value 340.
//    The UInt32 value 4294967295 is outside the range of the Int16 type.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(UInt16)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 16 bit işaretsiz tamsayı değerini eşdeğer 16 bit işaretli tamsayıya dönüştürür.

[System.CLSCompliant(false)]
public static short ToInt16 (ushort value);

Parametreler

value
UInt16

Dönüştürülecek 16 bitlik işaretsiz tamsayı.

Döndürülenler

Int16

ile eşdeğer value16 bit işaretli bir tamsayı.

Öznitelikler
CLSCompliantAttribute

Özel durumlar

OverflowException

value Int16.MaxValue değerinden büyüktür.

Örnekler

Aşağıdaki örnek, işaretsiz 16 bit tamsayı dizisindeki her öğeyi 16 bit imzalı tamsayıya dönüştürmeyi dener.

ushort[] numbers = { UInt16.MinValue, 121, 340, UInt16.MaxValue };
short result;
foreach (ushort number in numbers)
{
   try {
      result = Convert.ToInt16(number);
      Console.WriteLine("Converted the {0} value {1} to a {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 Int16 type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//       Converted the UInt16 value 0 to a Int16 value 0.
//       Converted the UInt16 value 121 to a Int16 value 121.
//       Converted the UInt16 value 340 to a Int16 value 340.
//       The UInt16 value 65535 is outside the range of the Int16 type.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(String)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Bir sayının belirtilen dize gösterimini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.

public static short ToInt16 (string value);
public static short ToInt16 (string? value);

Parametreler

value
String

Dönüştürülecek sayıyı içeren bir dize.

Döndürülenler

Int16

içindeki sayıya valueeşdeğer 16 bit işaretli bir tamsayı veya ise value 0 (sıfır) olur null.

Özel durumlar

FormatException

value , isteğe bağlı bir işaretin ardından bir basamak dizisi (0 ile 9 arasında) arasında bir işaretten oluşmaz.

OverflowException

value Int16.MinValue değerinden küçük veya Int16.MaxValue değerinden büyük bir sayıyı temsil eder.

Örnekler

Aşağıdaki örnek, varsayılan biçimlendirmeyi kullanarak 16 bit tamsayıların dize gösterimlerini yöntemiyle ToInt16 dönüştürür.

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

class ToInt16ProviderDemo
{
    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 ConvertToInt16( string numericStr,
        IFormatProvider provider )
    {
        object defaultValue;
        object providerValue;

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

        // Convert numericStr to Int16 with a format provider.
        try
        {
            providerValue = Convert.ToInt16( 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.NumberGroupSeparator = ",";
        provider.NumberGroupSizes = new int[ ] { 3 };
        provider.NumberNegativePattern = 0;

        Console.WriteLine("This example of\n" +
            "  Convert.ToInt16( string ) and \n" +
            "  Convert.ToInt16( string, IFormatProvider ) " +
            "\ngenerates the following output. It converts " +
            "several strings to \nshort 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.
        ConvertToInt16( "12345", provider );
        ConvertToInt16( "+12345", provider );
        ConvertToInt16( "pos 12345", provider );
        ConvertToInt16( "-12345", provider );
        ConvertToInt16( "neg 12345", provider );
        ConvertToInt16( "12345.", provider );
        ConvertToInt16( "12,345", provider );
        ConvertToInt16( "(12345)", provider );
        ConvertToInt16( "32768", provider );
        ConvertToInt16( "-32769", provider );
    }
}

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

String to convert   Default/exception   Provider/exception
-----------------   -----------------   ------------------
12345               12345               12345
+12345              12345               FormatException
pos 12345           FormatException     12345
-12345              -12345              FormatException
neg 12345           FormatException     -12345
12345.              FormatException     FormatException
12,345              FormatException     FormatException
(12345)             FormatException     FormatException
32768               OverflowException   OverflowException
-32769              OverflowException   FormatException
*/

Açıklamalar

yönteminin ToInt16(String) kullanılması yöntemine geçirmekle valueInt16.Parse(String) eşdeğerdir. value geçerli kültürün biçimlendirme kuralları kullanılarak yorumlanır.

Dönüştürme başarısız olursa bir özel durumu işlemeyi tercih ederseniz, bunun yerine yöntemini çağırabilirsiniz Int16.TryParse . Dönüştürmenin başarılı mı yoksa başarısız mı olduğunu gösteren bir Boolean değer döndürür.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(String, Int32)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen tabandaki bir sayının dize gösterimini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.

public static short ToInt16 (string value, int fromBase);
public static short ToInt16 (string? value, int fromBase);

Parametreler

value
String

Dönüştürülecek sayıyı içeren bir dize.

fromBase
Int32

içindeki value2, 8, 10 veya 16 olması gereken sayının tabanı.

Döndürülenler

Int16

içindeki sayıya valueeşdeğer 16 bit işaretli bir tamsayı veya ise value 0 (sıfır) olur null.

Özel durumlar

ArgumentException

fromBase 2, 8, 10 veya 16 değildir.

-veya-

value, temel olmayan 10 imzalı bir sayıyı temsil eder, negatif bir işaret ön ekli.

ArgumentOutOfRangeException

value, Empty değeridir.

FormatException

value tarafından fromBasebelirtilen tabanda geçerli bir basamak olmayan bir karakter içerir. Özel durum iletisi, içindeki value ilk karakter geçersizse dönüştürülecek basamak olmadığını gösterir; aksi takdirde ileti, sonunda geçersiz karakterler olduğunu value gösterir.

OverflowException

value, temel olmayan 10 imzalı bir sayıyı temsil eder, negatif bir işaret ön ekli.

-veya-

value Int16.MinValue değerinden küçük veya Int16.MaxValue değerinden büyük bir sayıyı temsil eder.

Örnekler

Aşağıdaki örnek, bir dize dizisindeki her öğeyi onaltılık dize olarak yorumlamayı ve 16 bit imzalı bir tamsayıya dönüştürmeyi dener.

using System;

public class Example
{
   public static void Main()
   {
      string[] hexStrings = { "8000", "0FFF", "f000", "00A30", "D", "-13",
                              "9AC61", "GAD" };
      foreach (string hexString in hexStrings)
      {
         try {
            short number = Convert.ToInt16(hexString, 16);
            Console.WriteLine("Converted '{0}' to {1:N0}.", hexString, number);
         }
         catch (FormatException) {
            Console.WriteLine("'{0}' is not in the correct format for a hexadecimal number.",
                              hexString);
         }
         catch (OverflowException) {
            Console.WriteLine("'{0}' is outside the range of an Int16.", hexString);
         }
         catch (ArgumentException) {
            Console.WriteLine("'{0}' is invalid in base 16.", hexString);
         }
      }
   }
}
// The example displays the following output:
//       Converted '8000' to -32,768.
//       Converted '0FFF' to 4,095.
//       Converted 'f000' to -4,096.
//       Converted '00A30' to 2,608.
//       Converted 'D' to 13.
//       '-13' is invalid in base 16.
//       '9AC61' is outside the range of an Int16.
//       'GAD' is not in the correct format for a hexadecimal number.

Açıklamalar

16 ise fromBase , parametresi tarafından belirtilen sayıya value "0x" veya "0X" ön eki ekleyebilirsiniz.

Negatif işareti temel olmayan 10 sayısal gösterimler için desteklenmediğinden, ToInt16(String, Int32) yöntem negatif sayıların ikinin tamamlayıcı gösterimini kullandığını varsayar. Başka bir deyişle, yöntemi her zaman bir tamsayının en yüksek sıralı ikili bitini (bit 15) işaret biti olarak yorumlar. Sonuç olarak, yöntem özel durum oluşturmadan veri türü aralığının dışında olan 10 tabanı olmayan bir sayının Int16 bir Int16 değere dönüştürüldüğü kod yazmak mümkündür. Aşağıdaki örnek bir artırılır Int16.MaxValue , elde edilen sayıyı onaltılık dize gösterimine dönüştürür ve ardından yöntemini çağırır ToInt16(String, Int32) . Yöntemi bir özel durum atmak yerine "0x8000 -32768'e dönüştürür" iletisini görüntüler.

// Create a hexadecimal value out of range of the Int16 type.
string value = Convert.ToString((int) short.MaxValue + 1, 16);
// Convert it back to a number.
try
{
   short number = Convert.ToInt16(value, 16);
   Console.WriteLine("0x{0} converts to {1}.", value, number);
}
catch (OverflowException)
{
   Console.WriteLine("Unable to convert '0x{0}' to a 16-bit integer.", value);
}

İkili işlemler veya sayısal dönüştürme gerçekleştirirken, bir yöntemin belirli bir değeri yorumlamak için uygun sayısal gösterimi bir yöntemi kullandığını doğrulamak için her zaman geliştiricinin sorumluluğundadır. Aşağıdaki örnekte gösterildiği gibi, yöntemin onaltılık dize gösterimine dönüştürmeden önce sayısal değerin işaretini alarak taşma işlemlerini uygun şekilde işlediğinden emin olabilirsiniz. Özgün değer pozitifse ancak bir tamsayıya geri dönüştürme negatif bir değer verirse bir özel durum oluşturur.

// Create a hexadecimal value out of range of the Short type.
int sourceNumber = (int) short.MaxValue + 1;
bool isNegative = (Math.Sign(sourceNumber) == -1);
string value = Convert.ToString(sourceNumber, 16);
short targetNumber;
try
{
   targetNumber = Convert.ToInt16(value, 16);
   if (! isNegative && ((targetNumber & 0x8000) != 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 16-bit integer.", value);
}
// Displays the following to the console:
//    Unable to convert '0x8000' to a 16-bit integer.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(SByte)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 8 bit işaretli tamsayı değerini eşdeğer 16 bit işaretli tamsayıya dönüştürür.

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

Parametreler

value
SByte

Dönüştürülecek 8 bit işaretli tamsayı.

Döndürülenler

Int16

ile eşdeğer value8 bit işaretli bir tamsayı.

Öznitelikler
CLSCompliantAttribute

Örnekler

Aşağıdaki örnek, imzalı bayt dizisindeki her öğeyi 16 bit imzalı tamsayıya dönüştürür.

sbyte[] numbers = { SByte.MinValue, -1, 0, 10, SByte.MaxValue };
short result;

foreach (sbyte number in numbers)
{
   result = Convert.ToInt16(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                     number.GetType().Name, number,
                     result.GetType().Name, result);
}
// The example displays the following output:
//       Converted the SByte value -128 to the Int16 value -128.
//       Converted the SByte value -1 to the Int16 value -1.
//       Converted the SByte value 0 to the Int16 value 0.
//       Converted the SByte value 10 to the Int16 value 10.
//       Converted the SByte value 127 to the Int16 value 127.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(Int16)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen 16 bit işaretli tamsayıyı döndürür; gerçek dönüştürme gerçekleştirilmemesi.

public static short ToInt16 (short value);

Parametreler

value
Int16

Döndürülecek 16 bit işaretli tamsayı.

Döndürülenler

Int16

value değiştirilmeden döndürülür.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(Int64)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen 64 bit işaretli tamsayı değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.

public static short ToInt16 (long value);

Parametreler

value
Int64

Dönüştürülecek 64 bit işaretli tamsayı.

Döndürülenler

Int16

ile eşdeğer value16 bit işaretli bir tamsayı.

Özel durumlar

OverflowException

value Int16.MaxValue değerinden büyük veya Int16.MinValue değerinden küçüktür.

Örnekler

Aşağıdaki örnek, uzun tamsayılar dizisindeki her öğeyi 16 bit imzalı bir tamsayıya dönüştürmeyi dener.

long[] numbers = { Int64.MinValue, -1, 0, 121, 340, Int64.MaxValue };
short result;

foreach (long number in numbers)
{
   try {
      result = Convert.ToInt16(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 Int16 type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    The Int64 value -9223372036854775808 is outside the range of the Int16 type.
//    Converted the Int64 value -1 to the Int16 value -1.
//    Converted the Int64 value 0 to the Int16 value 0.
//    Converted the Int64 value 121 to the Int16 value 121.
//    Converted the Int64 value 340 to the Int16 value 340.
//    The Int64 value 9223372036854775807 is outside the range of the Int16 type.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(Int32)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen 32 bit işaretli tamsayı değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.

public static short ToInt16 (int value);

Parametreler

value
Int32

Dönüştürülecek 32 bit işaretli tamsayı.

Döndürülenler

Int16

16 bit işaretli tamsayı eşdeğeri.value

Özel durumlar

OverflowException

value Int16.MaxValue değerinden büyük veya Int16.MinValue değerinden küçüktür.

Örnekler

Aşağıdaki örnek, bir tamsayı dizisindeki her öğeyi 16 bit imzalı bir tamsayıya dönüştürmeyi dener.

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

foreach (int number in numbers)
{
   try {
      result = Convert.ToInt16(number);
      Console.WriteLine("Converted the {0} value {1} to a {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 Int16 type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output:
//    The Int32 value -2147483648 is outside the range of the Int16 type.
//    Converted the Int32 value -1 to a Int16 value -1.
//    Converted the Int32 value 0 to a Int16 value 0.
//    Converted the Int32 value 121 to a Int16 value 121.
//    Converted the Int32 value 340 to a Int16 value 340.
//    The Int32 value 2147483647 is outside the range of the Int16 type.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(Double)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen çift duyarlıklı kayan nokta sayısının değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.

public static short ToInt16 (double value);

Parametreler

value
Double

Dönüştürülecek çift duyarlıklı kayan nokta sayısı.

Döndürülenler

Int16

value, en yakın 16 bit işaretli tamsayıya yuvarlanmış. İki tamsayının ortasındaysa value çift sayı döndürülür; yani 4,5 4'e, 5,5 ise 6'ya dönüştürülür.

Özel durumlar

OverflowException

value Int16.MaxValue değerinden büyük veya Int16.MinValue değerinden küçüktür.

Örnekler

Aşağıdaki örnek, bir değer dizisindeki Double her öğeyi 16 bit imzalı bir tamsayıya dönüştürür. Örnekte, bir değerin herhangi bir Double kesirli bölümünün dönüştürme işlemi gerçekleştirilmeden önce yuvarlandığını gösterilmektedir.

double[] values = { Double.MinValue, -1.38e10, -1023.299, -12.98,
                    0, 9.113e-16, 103.919, 17834.191, Double.MaxValue };
short result;

foreach (double value in values)
{
   try {
      result = Convert.ToInt16(value);
      Console.WriteLine("Converted {0} to {1}.", value, result);
   }
   catch (OverflowException)
   {
      Console.WriteLine("{0} is outside the range of the Int16 type.", value);
   }
}
//       -1.79769313486232E+308 is outside the range of the Int16 type.
//       -13800000000 is outside the range of the Int16 type.
//       Converted -1023.299 to -1023.
//       Converted -12.98 to -13.
//       Converted 0 to 0.
//       Converted 9.113E-16 to 0.
//       Converted 103.919 to 104.
//       Converted 17834.191 to 17834.
//       1.79769313486232E+308 is outside the range of the Int16 type.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(Decimal)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen ondalık sayının değerini eşdeğer bir 16 bit işaretli tamsayıya dönüştürür.

public static short ToInt16 (decimal value);

Parametreler

value
Decimal

Dönüştürülecek ondalık sayı.

Döndürülenler

Int16

value, en yakın 16 bit işaretli tamsayıya yuvarlanmış. İki tamsayının ortasındaysa value çift sayı döndürülür; yani 4,5 4'e, 5,5 ise 6'ya dönüştürülür.

Özel durumlar

OverflowException

value Int16.MaxValue değerinden büyük veya Int16.MinValue değerinden küçüktür.

Örnekler

Aşağıdaki örnek, bir değer dizisindeki Decimal her öğeyi 16 bit imzalı bir tamsayıya dönüştürmeyi dener. Örnekte, dönüştürme yapılırken değerin herhangi bir Decimal kesirli bölümünün yuvarlandığını gösterilmektedir.

decimal[] values = { Decimal.MinValue, -1034.23m, -12m, 0m, 147m,
                            9214.16m, Decimal.MaxValue };
short result;

foreach (decimal value in values)
{
   try {
      result = Convert.ToInt16(value);
      Console.WriteLine("Converted {0} to {1}.", value, result);
   }
   catch (OverflowException)
   {
      Console.WriteLine("{0} is outside the range of the Int16 type.",
                        value);
   }
}
// The example displays the following output:
//    -79228162514264337593543950335 is outside the range of the Int16 type.
//    Converted -1034.23 to -1034.
//    Converted -12 to -12.
//    Converted 0 to 0.
//    Converted 147 to 147.
//    Converted 9214.16 to 9214.
//    79228162514264337593543950335 is outside the range of the Int16 type.

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(DateTime)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Bu yöntemin çağrılması her zaman oluşturur InvalidCastException.

public static short ToInt16 (DateTime value);

Parametreler

value
DateTime

Dönüştürülecek tarih ve saat değeri.

Döndürülenler

Int16

Bu dönüşüm desteklenmiyor. Hiçbir değer döndürülmez.

Özel durumlar

InvalidCastException

Bu dönüşüm desteklenmiyor.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(Char)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen Unicode karakterinin değerini eşdeğer 16 bit işaretli tamsayıya dönüştürür.

public static short ToInt16 (char value);

Parametreler

value
Char

Dönüştürülecek Unicode karakteri.

Döndürülenler

Int16

ile eşdeğer value16 bit işaretli bir tamsayı.

Özel durumlar

OverflowException

value Int16.MaxValue değerinden büyüktür.

Örnekler

Aşağıdaki örnek, bir değer dizisindeki Char her öğeyi 16 bit imzalı bir tamsayıya dönüştürmeyi dener.

char[] chars = { 'a', 'z', '\x0007', '\x03FF',
                 '\x7FFF', '\xFFFE' };
short result;

foreach (char ch in chars)
{
   try {
      result = Convert.ToInt16(ch);
      Console.WriteLine("'{0}' converts to {1}.", ch, result);
   }
   catch (OverflowException) {
      Console.WriteLine("Unable to convert u+{0} to an Int16.",
                        ((int)ch).ToString("X4"));
   }
}
// The example displays the following output:
//       'a' converts to 97.
//       'z' converts to 122.
//       '' converts to 7.
//       'Ͽ' converts to 1023.
//       '翿' converts to 32767.
//       Unable to convert u+FFFE to an Int16.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(Byte)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen 8 bit işaretsiz tamsayı değerini eşdeğer 16 bit işaretli tamsayıya dönüştürür.

public static short ToInt16 (byte value);

Parametreler

value
Byte

Dönüştürülecek 8 bit işaretsiz tamsayı.

Döndürülenler

Int16

ile eşdeğer value16 bit işaretli bir tamsayı.

Örnekler

Aşağıdaki örnek, bir değer dizisindeki Byte her öğeyi 16 bit imzalı bir tamsayıya dönüştürür.

byte[] bytes = { Byte.MinValue, 14, 122, Byte.MaxValue};
short result;

foreach (byte byteValue in bytes)
{
   result = Convert.ToInt16(byteValue);
   Console.WriteLine("The Byte value {0} converts to {1}.",
                     byteValue, result);
}
// The example displays the following output:
//       The Byte value 0 converts to 0.
//       The Byte value 14 converts to 14.
//       The Byte value 122 converts to 122.
//       The Byte value 255 converts to 255.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(Boolean)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen Boole değerini eşdeğer 16 bit işaretli tamsayıya dönüştürür.

public static short ToInt16 (bool value);

Parametreler

value
Boolean

Dönüştürülecek Boole değeri.

Döndürülenler

Int16

1 value ise, değilse 0 sayısıdır true.

Örnekler

Aşağıdaki örnek Boole değerlerini ve false değerlerini true değerlere Int16 dönüştürür.

bool falseFlag = false;
bool trueFlag = true;

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

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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

ToInt16(Object)

Kaynak:
Convert.cs
Kaynak:
Convert.cs
Kaynak:
Convert.cs

Belirtilen nesnenin değerini 16 bit imzalı tamsayıya dönüştürür.

public static short ToInt16 (object value);
public static short ToInt16 (object? value);

Parametreler

value
Object

arabirimini IConvertible uygulayan bir nesne veya null.

Döndürülenler

Int16

ile eşdeğer valuebir 16 bit işaretli tamsayı veya ise value sıfır.null

Özel durumlar

FormatException

value türü için Int16 uygun bir biçimde değil.

InvalidCastException

value arabirimini IConvertible uygulamaz.

-veya-

Dönüşüm desteklenmiyor.

OverflowException

value Int16.MinValue değerinden küçük veya Int16.MaxValue değerinden büyük bir sayıyı temsil eder.

Örnekler

Aşağıdaki örnek, bir nesne dizisindeki her öğeyi 16 bit imzalı tamsayıya dönüştürmeyi dener.

object[] values= { true, -12, 163, 935, 'x', new DateTime(2009, 5, 12),
                   "104", "103.0", "-1", "1.00e2", "One", 1.00e2};
short result;

foreach (object value in values)
{
   try {
      result = Convert.ToInt16(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 Int16 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 an Int16 exists for the {0} value {1}.",
                        value.GetType().Name, value);
   }
}
// The example displays the following output:
//    Converted the Boolean value True to the Int16 value 1.
//    Converted the Int32 value -12 to the Int16 value -12.
//    Converted the Int32 value 163 to the Int16 value 163.
//    Converted the Int32 value 935 to the Int16 value 935.
//    Converted the Char value x to the Int16 value 120.
//    No conversion to an Int16 exists for the DateTime value 5/12/2009 12:00:00 AM.
//    Converted the String value 104 to the Int16 value 104.
//    The String value 103.0 is not in a recognizable format.
//    Converted the String value -1 to the Int16 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 Int16 value 100.

Açıklamalar

değilse valuenull, bu yöntem temel alınan türünün uygulamasına IConvertible.ToInt16 bir çağrı sarmalar value.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.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