Int16.ToString Methode

Definitie

Naamruimte:: System

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave.

Overloads

Name	Description
ToString(IFormatProvider)	Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven cultuurspecifieke notatiegegevens.
ToString(String, IFormatProvider)	Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven notatie en cultuurspecifieke opmaakgegevens.
ToString(String)	Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave, met behulp van de opgegeven indeling.
ToString()	Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave.

ToString(IFormatProvider)

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven cultuurspecifieke notatiegegevens.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public string ToString(IFormatProvider provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Parameters

provider: IFormatProvider

Een IFormatProvider die cultuurspecifieke opmaakgegevens levert.

Retouren

String

De tekenreeksweergave van de waarde van dit exemplaar zoals opgegeven door provider.

Implementeringen

ToString(IFormatProvider)

Voorbeelden

In het volgende voorbeeld wordt een matrix met Int16 waarden herhaald en worden ze allemaal weergegeven in de console door de Int16.ToString(IFormatProvider) methode aan te roepen met verschillende indelingsproviders. Vanwege de eenvoudige opmaak die door de standaardnotatieaanduiding G is gedefinieerd, zijn de opgemaakte tekenreeksen die voor elke Int16 waarde worden geproduceerd, identiek, ongeacht de waarde van de provider parameter.

short[] numbers = {-23092, 0, 14894, Int16.MaxValue};
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("de-de"),
                           new CultureInfo("es-es")};
foreach (Int16 int16Value in numbers)
{
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0, 6} ({1})     ",
                    int16Value.ToString(provider),
                    provider.Name);
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
//            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
//        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
//        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)

let numbers = [ -23092s; 0s; 14894s; Int16.MaxValue ]
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "de-de"
      CultureInfo "es-es" ]

for int16Value in numbers do
    for provider in providers do
        printf $"{int16Value.ToString provider, 6} ({provider.Name})     "
                    
    printfn ""

// The example displays the following output to the console:
//       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
//            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
//        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
//        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)

Dim numbers() As Short = {-23092, 0, 14894, Int16.MaxValue}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
For Each int16Value As Short In Numbers
   For Each provider As CultureInfo In providers
      Console.Write("{0, 6} ({1})     ", _
                    int16Value.ToString(provider), _
                    provider.Name)
   Next                     
   Console.WriteLine()
Next 
' The example displays the following output to the console:
'       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
'            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
'        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
'        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)

Opmerkingen

Met ToString(IFormatProvider) de methode wordt een Int16 waarde in de standaardnotatie (G of algemeen) opgemaakt met behulp van het NumberFormatInfo object van een opgegeven cultuur. Als u een andere notatie of de huidige cultuur wilt opgeven, gebruikt u de andere overbelasting van de ToString methode als volgt:

Indeling gebruiken	Voor cultuur	De overbelasting gebruiken
Standaardnotatie ('G')	Standaardcultuur (huidige)	ToString()
Een specifieke indeling	Standaardcultuur (huidige)	ToString(String)
Een specifieke indeling	Een specifieke cultuur	ToString(String, IFormatProvider)

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

Zie Standaardtekenreeksen voor numerieke notatie en tekenreeksen met aangepaste numerieke notatie voor meer informatie over numerieke notatieaanduidingen.
Zie Opmaaktypen voor meer informatie over opmaak.

De provider parameter is een IFormatProvider implementatie waarvan de IFormatProvider.GetFormat methode een NumberFormatInfo object retourneert. provider Dit is meestal een NumberFormatInfo object of een CultureInfo object. Het NumberFormatInfo object biedt cultuurspecifieke informatie over de indeling van de tekenreeks die door deze methode wordt geretourneerd. Als provider dat het geval is null, wordt dit exemplaar opgemaakt met het NumberFormatInfo object voor de huidige cultuur.

Zie ook

Van toepassing op

ToString(String, IFormatProvider)

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven notatie en cultuurspecifieke opmaakgegevens.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString(string format, IFormatProvider provider);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

Parameters

format: String

Een tekenreeks met een numerieke notatie.

provider: IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie levert.

Retouren

String

De tekenreeksweergave van de waarde van dit exemplaar zoals opgegeven door format en provider.

Implementeringen

ToString(String, IFormatProvider)

Voorbeelden

In het volgende voorbeeld wordt een Int16 waarde weergegeven met elk van de ondersteunde tekenreeksen voor standaardindelingen in vier verschillende culturen.

Int16 value = 14603;
string[] formats = {"C", "D6", "e1", "E2", "F1", "G", "N1",
                    "P0", "X4", "000000.0000", "##000.0"};
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("de-de"),
                           new CultureInfo("es-es")};
// Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers[0], providers[1],
                  providers[2], providers[3]);
Console.WriteLine();
// Display a value using each format string.
foreach (string format in formats)
{
   // Display the value for each provider on the same line.
   Console.Write("{0,-12}", format);
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0,12}  ",
                    value.ToString(format, provider));
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//                       en-US         fr-FR         de-DE         es-ES
//
//    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €
//    D6                014603        014603        014603        014603
//    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004
//    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004
//    F1               14603.0       14603,0       14603,0       14603,0
//    G                  14603         14603         14603         14603
//    N1              14,603.0      14 603,0      14.603,0      14.603,0
//    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %
//    X4                  390B          390B          390B          390B
//    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000
//    ##000.0          14603.0       14603,0       14603,0       14603,0

 let value = 14603
 let formats =
     [ "C"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
       "P0"; "X4"; "000000.0000"; "##000.0" ]
 let providers = 
     [ CultureInfo "en-us"
       CultureInfo "fr-fr"
       CultureInfo "de-de"
       CultureInfo "es-es" ]
 // Display header.
 printfn $"{providers[0],24}{providers[1],14}{providers[2],14}{providers[3],14}\n"
 
 // Display a value using each format string.
 for format in formats do
     // Display the value for each provider on the same line.
     printf $"{format,-12}"
     for provider in providers do
         printf $"{value.ToString(format, provider),12}  "
     printfn ""

// The example displays the following output to the console:
//                       en-US         fr-FR         de-DE         es-ES
//
//    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €
//    D6                014603        014603        014603        014603
//    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004
//    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004
//    F1               14603.0       14603,0       14603,0       14603,0
//    G                  14603         14603         14603         14603
//    N1              14,603.0      14 603,0      14.603,0      14.603,0
//    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %
//    X4                  390B          390B          390B          390B
//    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000
//    ##000.0          14603.0       14603,0       14603,0       14603,0

Dim value As Int16 = 14603
Dim formats() As String = {"C", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
' Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers(0), providers(1), _
                  providers(2), providers(3))
Console.WriteLine()                        
' Display a value using each format string.
For Each format As String In formats
   ' Display the value for each provider on the same line.
   Console.Write("{0,-12}", format)
   For Each provider As CultureInfo In providers
      Console.Write("{0,12}  ", _
                    value.ToString(format, provider)) 
   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'                       en-US         fr-FR         de-DE         es-ES
'    
'    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €  
'    D6                014603        014603        014603        014603  
'    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004  
'    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004  
'    F1               14603.0       14603,0       14603,0       14603,0  
'    G                  14603         14603         14603         14603  
'    N1              14,603.0      14 603,0      14.603,0      14.603,0  
'    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %  
'    X4                  390B          390B          390B          390B  
'    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000  
'    ##000.0          14603.0       14603,0       14603,0       14603,0

Opmerkingen

Met ToString(String, IFormatProvider) de methode wordt een Int16 waarde in een opgegeven indeling opgemaakt met behulp van het NumberFormatInfo object van een opgegeven cultuur. Als u standaardindeling of cultuurinstellingen wilt gebruiken, gebruikt u de andere overbelasting van de ToString methode als volgt:

Indeling gebruiken	Voor cultuur	De overbelasting gebruiken
Standaardnotatie ('G')	Standaardcultuur (huidige)	ToString()
Standaardnotatie ('G')	Een specifieke cultuur	ToString(IFormatProvider)
Een specifieke indeling	Standaardcultuur (huidige)	ToString(String)

De format parameter kan een standaardtekenreeks of een aangepaste numerieke notatietekenreeks zijn. Alle standaardtekenreeksen voor numerieke notaties behalve R (of R) worden ondersteund, net als alle aangepaste numerieke notatietekens. Als format dit een of een lege tekenreeks ("") is null , wordt de tekenreeks die door deze methode wordt geretourneerd, opgemaakt met de algemene numerieke notatieaanduiding ('G').

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

Zie Standaardtekenreeksen voor numerieke notatie en tekenreeksen met aangepaste numerieke notatie voor meer informatie over numerieke notatieaanduidingen.
Zie Opmaaktypen voor meer informatie over opmaak.

De provider parameter is een IFormatProvider implementatie. De GetFormat methode retourneert een NumberFormatInfo object dat cultuurspecifieke informatie biedt over de indeling van de tekenreeks die door deze methode wordt geretourneerd. Het object dat wordt geïmplementeerd IFormatProvider , kan een van de volgende zijn:

Een CultureInfo object dat de cultuur vertegenwoordigt waarvan de opmaakregels moeten worden gebruikt.
Een NumberFormatInfo object met specifieke numerieke opmaakgegevens voor deze waarde.
Een aangepast object dat implementeert IFormatProvider.

Als provider is null, of een NumberFormatInfo object kan niet worden verkregen van provider, wordt de retourwaarde opgemaakt met de NumberFormatInfo voor de huidige cultuur.

Zie ook

Van toepassing op

ToString(String)

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave, met behulp van de opgegeven indeling.

public:
 System::String ^ ToString(System::String ^ format);

public string ToString(string format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

Parameters

format: String

Een tekenreeks met een numerieke notatie.

Retouren

String

De tekenreeksweergave van de waarde van dit exemplaar zoals opgegeven door format.

Voorbeelden

In het volgende voorbeeld worden twee Int16 waarden geïnitialiseerd en weergegeven in de console met behulp van elk van de ondersteunde tekenreeksen voor standaardindelingen en verschillende tekenreeksen voor aangepaste notatie. Het voorbeeld wordt uitgevoerd met en-US als de huidige cultuur.

Int16[] values = {-23805, 32194};
string[] formats = {"C4", "D6", "e1", "E2", "F1", "G", "N1",
                    "P0", "X4", "000000.0000", "##000.0"};
foreach (string format in formats)
{
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}",
                     format,
                     values[0].ToString(format),
                     values[1].ToString(format));
}
// The example displays the following output to the console:
//    'C4' format specifier:    ($23,805.0000)        $32,194.0000
//    'D6' format specifier:           -023805              032194
//    'e1' format specifier:         -2.4e+004            3.2e+004
//    'E2' format specifier:        -2.38E+004           3.22E+004
//    'F1' format specifier:          -23805.0             32194.0
//    ' G' format specifier:            -23805               32194
//    'N1' format specifier:         -23,805.0            32,194.0
//    'P0' format specifier:      -2,380,500 %         3,219,400 %
//    'X4' format specifier:              A303                7DC2
//    '000000.0000' format specifier:      -023805.0000         032194.0000
//    '##000.0' format specifier:          -23805.0             32194.0

let values = [| -23805s; 32194s |]
let formats = 
    [ "C4"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
      "P0"; "X4"; "000000.0000"; "##000.0" ]
for format in formats do
    printfn $"'{format,2}' format specifier: {values[0].ToString format,17}   {values[1].ToString format,17}"

// The example displays the following output to the console:
//    'C4' format specifier:    ($23,805.0000)        $32,194.0000
//    'D6' format specifier:           -023805              032194
//    'e1' format specifier:         -2.4e+004            3.2e+004
//    'E2' format specifier:        -2.38E+004           3.22E+004
//    'F1' format specifier:          -23805.0             32194.0
//    ' G' format specifier:            -23805               32194
//    'N1' format specifier:         -23,805.0            32,194.0
//    'P0' format specifier:      -2,380,500 %         3,219,400 %
//    'X4' format specifier:              A303                7DC2
//    '000000.0000' format specifier:      -023805.0000         032194.0000
//    '##000.0' format specifier:          -23805.0             32194.0

Dim values() As Int16 = {-23805, 32194}
Dim formats() As String = {"C4", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
For Each format As String In formats
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}", _ 
                     format, _
                     values(0).ToString(format), _
                     values(1).ToString(format))
Next                                                               
' The example displays the following output to the console:
'    'C4' format specifier:    ($23,805.0000)        $32,194.0000
'    'D6' format specifier:           -023805              032194
'    'e1' format specifier:         -2.4e+004            3.2e+004
'    'E2' format specifier:        -2.38E+004           3.22E+004
'    'F1' format specifier:          -23805.0             32194.0
'    ' G' format specifier:            -23805               32194
'    'N1' format specifier:         -23,805.0            32,194.0
'    'P0' format specifier:      -2,380,500 %         3,219,400 %
'    'X4' format specifier:              A303                7DC2
'    '000000.0000' format specifier:      -023805.0000         032194.0000
'    '##000.0' format specifier:          -23805.0             32194.0

Opmerkingen

Met ToString(String) de methode wordt een Int16 waarde in een opgegeven indeling opgemaakt met behulp van een NumberFormatInfo object dat de conventies van de huidige cultuur vertegenwoordigt. Als u de standaardindeling ('G', of algemeen) wilt gebruiken of een andere cultuur wilt opgeven, gebruikt u de andere overbelastingen van de ToString methode als volgt:

Indeling gebruiken	Voor cultuur	De overbelasting gebruiken
Standaardnotatie ('G')	Standaardcultuur (huidige)	ToString()
Standaardnotatie ('G')	Een specifieke cultuur	ToString(IFormatProvider)
Een specifieke indeling	Een specifieke cultuur	ToString(String, IFormatProvider)

De format parameter kan een standaardtekenreeks of een aangepaste numerieke notatietekenreeks zijn. Alle standaardtekenreeksen voor numerieke notaties behalve R (of R) worden ondersteund, net als alle aangepaste numerieke notatietekens. Als format dit een of een lege tekenreeks is null , wordt de retourwaarde van dit exemplaar opgemaakt met de algemene numerieke notatieaanduiding ('G').

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

Zie Standaardtekenreeksen voor numerieke notatie en tekenreeksen met aangepaste numerieke notatie voor meer informatie over numerieke notatieaanduidingen.
Zie Opmaaktypen voor meer informatie over opmaak.

De retourwaarde van dit exemplaar is opgemaakt met de NumberFormatInfo huidige cultuur.

Zie ook

Van toepassing op

ToString()

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave.

public:
 override System::String ^ ToString();

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retouren

String

De tekenreeksweergave van de waarde van dit exemplaar, bestaande uit een minteken als de waarde negatief is, en een reeks cijfers tussen 0 en 9 zonder voorloopnullen.

Voorbeelden

In het volgende voorbeeld wordt de ToString() methode gebruikt om een matrix met Int16 waarden weer te geven aan de console.

short[] numbers = {0, 14624, 13982, short.MaxValue,
                   short.MinValue, -16667};
foreach (short number in numbers)
{
   Console.WriteLine(number.ToString());
}
// The example displays the following output to the console:
//       0
//       14624
//       13982
//       32767
//       -32768
//       -16667

let numbers = [ 0s; 14624s; 13982s; Int16.MaxValue; Int16.MinValue; -16667s ]

for number in numbers do
    printfn $"{number.ToString()}"

// The example displays the following output to the console:
//       0
//       14624
//       13982
//       32767
//       -32768
//       -16667

Dim numbers() As Short = {0, 14624, 13982, Short.MaxValue, _
                         Short.MinValue, -16667}
For Each number As Short In numbers
   Console.WriteLine(number.ToString())
Next        
' The example displays the following output to the console:
'       0
'       14624
'       13982
'       32767
'       -32768
'       -16667

Opmerkingen

Met ToString() de methode wordt een Int16 waarde in de standaardnotatie (G of algemeen) opgemaakt met behulp van het NumberFormatInfo object van de huidige cultuur. Als u een andere indeling of cultuur wilt opgeven, gebruikt u de andere overbelasting van de ToString methode als volgt:

Indeling gebruiken	Voor cultuur	De overbelasting gebruiken
Standaardnotatie ('G')	Een specifieke cultuur	ToString(IFormatProvider)
Een specifieke indeling	Standaardcultuur (huidige)	ToString(String)
Een specifieke indeling	Een specifieke cultuur	ToString(String, IFormatProvider)

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

Zie Standaardtekenreeksen voor numerieke notatie en tekenreeksen met aangepaste numerieke notatie voor meer informatie over numerieke notatieaanduidingen.
Zie Opmaaktypen voor meer informatie over opmaak.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?