This documentation is archived and is not being maintained.

Convert.ToString Method (Int16, Int32)

.NET Framework 1.1

Converts the value of a 16-bit signed integer to its equivalent String representation in a specified base.

[Visual Basic]
Overloads Public Shared Function ToString( _
   ByVal value As Short, _
   ByVal toBase As Integer _
) As String
[C#]
public static string ToString(
 short value,
 int toBase
);
[C++]
public: static String* ToString(
 short value,
 int toBase
);
[JScript]
public static function ToString(
   value : Int16,
 toBase : int
) : String;

Parameters

value
A 16-bit signed integer.
toBase
The base of the return value, which must be 2, 8, 10, or 16.

Return Value

The String representation of value in base toBase.

Exceptions

Exception Type Condition
ArgumentException toBase is not 2, 8, 10, or 16.

Example

[Visual Basic, C#, C++] The following code example converts several Int16 (16-bit integers) to String s with the ToString method in the radixes supported by the method.

[Visual Basic] 
' Example of the Convert.ToString( Short, Integer ) method.
Imports System
Imports Microsoft.VisualBasic

Module ConvertRadixShortDemo
    
    Sub RunToStringDemo( )

        Dim values as Short( ) = { _
            Short.MinValue, _
            -100, _
            999, _
            Short.MaxValue }
        Dim radices as Integer( ) = { 2, 8, 10, 16 }

        ' Iterate through the values array.
        Dim value as Short
        For Each value in values

            ' Iterate through the radices.
            Dim radix as Integer
            For Each radix in radices

                ' Convert a value with a radix.
                Dim valueString As String = _
                    Convert.ToString( value, radix )

                Console.WriteLine( "{0,8}  {1,3}    {2}", _
                    value, radix, valueString )
            Next radix
        Next value
    End Sub 

    Sub Main( )

        Console.WriteLine( _
            "This example of Convert.ToString( Short, Integer ) " & _ 
            "generates " & vbCrLf & "the following output. It " & _
            "converts several Short values to " & vbCrLf & "strings " & _
            "using the radixes supported by the method." )
        Console.WriteLine( vbCrLf & _
            "   Value  Radix  String" & vbCrLf & _
            "   -----  -----  ------" )

        RunToStringDemo( )

    End Sub 
End Module 

' This example of Convert.ToString( Short, Integer ) generates
' the following output. It converts several Short values to
' strings using the radixes supported by the method.
' 
'    Value  Radix  String
'    -----  -----  ------
'   -32768    2    1000000000000000
'   -32768    8    100000
'   -32768   10    -32768
'   -32768   16    8000
'     -100    2    1111111110011100
'     -100    8    177634
'     -100   10    -100
'     -100   16    ff9c
'      999    2    1111100111
'      999    8    1747
'      999   10    999
'      999   16    3e7
'    32767    2    111111111111111
'    32767    8    77777
'    32767   10    32767
'    32767   16    7fff

[C#] 
// Example of the Convert.ToString( short, int ) method.
using System;

class ConvertRadixShortDemo
{
    static void RunToStringDemo( )
    {
        short[ ] values = {
            short.MinValue, 
            -100, 
            999, 
            short.MaxValue };
        int[ ]  radices = { 2, 8, 10, 16 };

        // Iterate through the values array.
        foreach( short value in values )
        {
            // Iterate through the radices.
            foreach( int radix in radices )
            {
                // Convert a value with a radix.
                string valueString = 
                    Convert.ToString( value, radix );

                Console.WriteLine( "{0,8}  {1,3}    {2}", 
                    value, radix, valueString );
            }
        }
    } 

    static void Main( )
    {
        Console.WriteLine(
            "This example of Convert.ToString( short, int ) " +
            "generates \nthe following output. It converts several " +
            "short values to \nstrings using the radixes supported " +
            "by the method." );
        Console.WriteLine( 
            "\n   Value  Radix  String" +
            "\n   -----  -----  ------" );

        RunToStringDemo( );
    } 
} 

/*
This example of Convert.ToString( short, int ) generates
the following output. It converts several short values to
strings using the radixes supported by the method.

   Value  Radix  String
   -----  -----  ------
  -32768    2    1000000000000000
  -32768    8    100000
  -32768   10    -32768
  -32768   16    8000
    -100    2    1111111110011100
    -100    8    177634
    -100   10    -100
    -100   16    ff9c
     999    2    1111100111
     999    8    1747
     999   10    999
     999   16    3e7
   32767    2    111111111111111
   32767    8    77777
   32767   10    32767
   32767   16    7fff
*/

[C++] 
// Example of the Convert::ToString( short, int ) method.
#using <mscorlib.dll>
using namespace System;
using namespace System::Collections;

void RunToStringDemo( )
{
    short values __gc [ ] = {
        Int16::MinValue, 
        -100, 
        999, 
        Int16::MaxValue };
    int  radices[ 4 ] = { 2, 8, 10, 16 };

    // Implement foreach( short value in values ).
    IEnumerator*    myEnum = values->GetEnumerator( );
    while( myEnum->MoveNext( ) )
    {
       short value = Convert::ToInt16( myEnum->Current );

        // Iterate through the radices.
        for( int i = 0; i < 4; i++ )
        {
            // Convert a value with a radix.
            int radix = radices[ i ];
            String* valueString = 
                Convert::ToString( value, radix );

            Console::WriteLine( S"{0,8}  {1,3}    {2}", 
                __box( value ), __box( radix ), valueString );
        }
    }
} 

void main()
{
    Console::WriteLine(
        S"This example of Convert::ToString( short, int ) " 
        S"generates \nthe following output. It converts several " 
        S"short values to \nstrings using the radixes supported " 
        S"by the method." );
    Console::WriteLine( 
        S"\n   Value  Radix  String" 
        S"\n   -----  -----  ------" );

    RunToStringDemo( );
} 

/*
This example of Convert::ToString( short, int ) generates
the following output. It converts several short values to
strings using the radixes supported by the method.

   Value  Radix  String
   -----  -----  ------
  -32768    2    1000000000000000
  -32768    8    100000
  -32768   10    -32768
  -32768   16    8000
    -100    2    1111111110011100
    -100    8    177634
    -100   10    -100
    -100   16    ff9c
     999    2    1111100111
     999    8    1747
     999   10    999
     999   16    3e7
   32767    2    111111111111111
   32767    8    77777
   32767   10    32767
   32767   16    7fff
*/

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

Convert Class | Convert Members | System Namespace | Convert.ToString Overload List

Show: