UInt16.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 indeling en cultuurspecifieke notatiegegevens.
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 object dat cultuurspecifieke opmaakinformatie levert.

Retouren

String

De tekenreeksweergave van de waarde van dit exemplaar, die bestaat uit een reeks cijfers tussen 0 en 9, zonder een teken of voorloopnullen.

Implementeringen

ToString(IFormatProvider)

Voorbeelden

In het volgende voorbeeld wordt een 16-bits geheel getal opgemaakt met behulp van verschillende notatieproviders, waaronder een voor de invariante cultuur. De uitvoer uit het voorbeeld illustreert dat de opgemaakte tekenreeks die door de ToString(IFormatProvider) methode wordt geretourneerd, hetzelfde is, ongeacht de indelingsprovider.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define an array of CultureInfo objects.
      CultureInfo[] ci = { new CultureInfo("en-US"), 
                           new CultureInfo("fr-FR"), 
                           CultureInfo.InvariantCulture }; 
      UInt16 value = 18924;
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        GetName(ci[0]), GetName(ci[1]), GetName(ci[2])); 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        value.ToString(ci[0]), value.ToString(ci[1]), value.ToString(ci[2]));   
   }

   private static string GetName(CultureInfo ci)
   {
      if (ci.Equals(CultureInfo.InvariantCulture))
         return "Invariant";
      else
         return ci.Name;         
   }
}
// The example displays the following output:
//          en-US          fr-FR      Invariant
//          18924          18924          18924

open System.Globalization

let getName (ci: CultureInfo) =
    if ci.Equals CultureInfo.InvariantCulture then "Invariant"
    else ci.Name

// Define an array of CultureInfo objects.
let ci = 
    [| CultureInfo "en-US" 
       CultureInfo "fr-FR" 
       CultureInfo.InvariantCulture |] 

let value = 18924us
printfn $"  {getName ci[0],12}   {getName ci[1],12}   {getName ci[2],12}"
printfn $"  {value.ToString ci[0],12}   {value.ToString ci[1],12}   {value.ToString ci[2],12}"
// The example displays the following output:
//          en-US          fr-FR      Invariant
//          18924          18924          18924

Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define an array of CultureInfo objects.
      Dim ci() As CultureInfo = { New CultureInfo("en-US"), _
                                  New CultureInfo("fr-FR"), _
                                  CultureInfo.InvariantCulture } 
      Dim value As UInt16 = 18924
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", _
                        GetName(ci(0)), GetName(ci(1)), GetName(ci(2))) 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", _
                        value.ToString(ci(0)), value.ToString(ci(1)), value.ToString(ci(2)))            
      
   End Sub
   
   Private Function GetName(ci As CultureInfo) As String
      If ci.Equals(CultureInfo.InvariantCulture) Then
         Return "Invariant"
      Else
         Return ci.Name
      End If   
   End Function
End Module
' The example displays the following output:
'         en-US          fr-FR      Invariant
'         18924          18924          18924

Opmerkingen

Met ToString(IFormatProvider) de methode wordt een UInt16 waarde opgemaakt in de standaardnotatie (G of algemeen) 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)

De provider parameter is een IFormatProvider implementatie. De GetFormat methode retourneert een NumberFormatInfo object dat cultuurspecifieke opmaakinformatie biedt. Geen van de eigenschappen van de NumberFormatInfo eigenschappen wordt echter gebruikt bij het opmaken met de algemene numerieke notatieaanduiding ('G').

Zie ook

Van toepassing op

ToString(String, IFormatProvider)

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

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)

Uitzonderingen

FormatException

format is ongeldig.

Voorbeelden

In het volgende voorbeeld wordt een 16-bits niet-ondertekende geheel getalwaarde weergegeven met behulp van de standaardaanduidingen voor numerieke notatie en een aantal specifieke CultureInfo objecten.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define cultures whose formatting conventions are to be used.
      CultureInfo[] cultures = { CultureInfo.CreateSpecificCulture("en-US"), 
                                 CultureInfo.CreateSpecificCulture("fr-FR"), 
                                 CultureInfo.CreateSpecificCulture("es-ES") };
      string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}; 
      ushort value = 22042;
      
      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 16}",  
                              specifier, culture.Name, 
                              value.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//        G format using en-US culture:            22042
//        G format using fr-FR culture:            22042
//        G format using es-ES culture:            22042
//       
//        C format using en-US culture:       $22,042.00
//        C format using fr-FR culture:      22 042,00 €
//        C format using es-ES culture:      22.042,00 €
//       
//       D4 format using en-US culture:            22042
//       D4 format using fr-FR culture:            22042
//       D4 format using es-ES culture:            22042
//       
//       E2 format using en-US culture:        2.20E+004
//       E2 format using fr-FR culture:        2,20E+004
//       E2 format using es-ES culture:        2,20E+004
//       
//        F format using en-US culture:         22042.00
//        F format using fr-FR culture:         22042,00
//        F format using es-ES culture:         22042,00
//       
//        N format using en-US culture:        22,042.00
//        N format using fr-FR culture:        22 042,00
//        N format using es-ES culture:        22.042,00
//       
//        P format using en-US culture:   2,204,200.00 %
//        P format using fr-FR culture:   2 204 200,00 %
//        P format using es-ES culture:   2.204.200,00 %
//       
//       X2 format using en-US culture:             561A
//       X2 format using fr-FR culture:             561A
//       X2 format using es-ES culture:             561A

open System.Globalization

// Define cultures whose formatting conventions are to be used.
let cultures = 
    [| CultureInfo.CreateSpecificCulture "en-US" 
       CultureInfo.CreateSpecificCulture "fr-FR"
       CultureInfo.CreateSpecificCulture "es-ES" |]
let specifiers = [| "G"; "C"; "D4"; "E2"; "F"; "N"; "P"; "X2" |] 
let value = 22042us

for specifier in specifiers do
    for culture in cultures do
        printfn $"{specifier,2} format using {culture.Name} culture: {value.ToString(specifier, culture), 16}"
    printfn ""
// The example displays the following output:
//        G format using en-US culture:            22042
//        G format using fr-FR culture:            22042
//        G format using es-ES culture:            22042
//       
//        C format using en-US culture:       $22,042.00
//        C format using fr-FR culture:      22 042,00 €
//        C format using es-ES culture:      22.042,00 €
//       
//       D4 format using en-US culture:            22042
//       D4 format using fr-FR culture:            22042
//       D4 format using es-ES culture:            22042
//       
//       E2 format using en-US culture:        2.20E+004
//       E2 format using fr-FR culture:        2,20E+004
//       E2 format using es-ES culture:        2,20E+004
//       
//        F format using en-US culture:         22042.00
//        F format using fr-FR culture:         22042,00
//        F format using es-ES culture:         22042,00
//       
//        N format using en-US culture:        22,042.00
//        N format using fr-FR culture:        22 042,00
//        N format using es-ES culture:        22.042,00
//       
//        P format using en-US culture:   2,204,200.00 %
//        P format using fr-FR culture:   2 204 200,00 %
//        P format using es-ES culture:   2.204.200,00 %
//       
//       X2 format using en-US culture:             561A
//       X2 format using fr-FR culture:             561A
//       X2 format using es-ES culture:             561A

Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define cultures whose formatting conventions are to be used.
      Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
                                       CultureInfo.CreateSpecificCulture("fr-FR"), _
                                       CultureInfo.CreateSpecificCulture("es-ES") }
      Dim specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"} 
      Dim value As UShort = 22042
      
      For Each specifier As String In specifiers
         For Each culture As CultureInfo In Cultures
            Console.WriteLine("{0,2} format using {1} culture: {2, 16}", _ 
                              specifier, culture.Name, _
                              value.ToString(specifier, culture))

         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'        G format using en-US culture:            22042
'        G format using fr-FR culture:            22042
'        G format using es-ES culture:            22042
'       
'        C format using en-US culture:       $22,042.00
'        C format using fr-FR culture:      22 042,00 €
'        C format using es-ES culture:      22.042,00 €
'       
'       D4 format using en-US culture:            22042
'       D4 format using fr-FR culture:            22042
'       D4 format using es-ES culture:            22042
'       
'       E2 format using en-US culture:        2.20E+004
'       E2 format using fr-FR culture:        2,20E+004
'       E2 format using es-ES culture:        2,20E+004
'       
'        F format using en-US culture:         22042.00
'        F format using fr-FR culture:         22042,00
'        F format using es-ES culture:         22042,00
'       
'        N format using en-US culture:        22,042.00
'        N format using fr-FR culture:        22 042,00
'        N format using es-ES culture:        22.042,00
'       
'        P format using en-US culture:   2,204,200.00 %
'        P format using fr-FR culture:   2 204 200,00 %
'        P format using es-ES culture:   2.204.200,00 %
'       
'       X2 format using en-US culture:             561A
'       X2 format using fr-FR culture:             561A
'       X2 format using es-ES culture:             561A

Opmerkingen

Met ToString(String, IFormatProvider) de methode wordt een UInt16 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 elke geldige standaardtekenreeks voor numerieke notatie zijn of een combinatie van tekenreeksen met aangepaste numerieke notatie. Als format dit gelijk is aan String.Empty of is null, wordt de retourwaarde van het huidige UInt16 object opgemaakt met de algemene notatieaanduiding ('G'). Als format er een andere waarde is, genereert de methode een FormatException.

.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. Wanneer de ToString(String, IFormatProvider) methode wordt aangeroepen, wordt de methode van provider de IFormatProvider.GetFormat parameter aangeroepen en doorgegeven aan een Type object dat het NumberFormatInfo type vertegenwoordigt. De GetFormat methode retourneert vervolgens het NumberFormatInfo object dat informatie biedt voor het opmaken van de huidige UInt16 waarde, zoals het groepsscheidingsteken of het decimaalteken. Er zijn drie manieren om de provider parameter te gebruiken om opmaakgegevens op te geven aan de ToString(String, IFormatProvider) methode:

U kunt een CultureInfo object doorgeven dat de cultuur vertegenwoordigt die opmaakinformatie levert. De GetFormat methode retourneert het NumberFormatInfo object dat numerieke opmaakinformatie biedt voor die cultuur.
U kunt het werkelijke NumberFormatInfo object doorgeven dat numerieke opmaakgegevens biedt. (De implementatie van GetFormat alleen retourneert zichzelf.)
U kunt een aangepast object doorgeven dat wordt geïmplementeerd IFormatProvider. De GetFormat methode instantieert en retourneert het NumberFormatInfo object dat opmaakinformatie biedt.

Als provider dat het is null, is de opmaak van de geretourneerde tekenreeks gebaseerd op het NumberFormatInfo object van 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.

Uitzonderingen

FormatException

De format parameter is ongeldig.

Voorbeelden

In het volgende voorbeeld wordt een 16-bits niet-ondertekende geheel getalwaarde weergegeven met behulp van elke standaardnotatietekenreeks en enkele aangepaste notatietekenreeksen.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      ushort value = 21708;
      string[] specifiers = { "G", "C", "D3", "E2", "e3", "F", 
                              "N", "P", "X", "000000.0", "#.0", 
                              "00000000;(0);**Zero**" };
      
      foreach (string specifier in specifiers)
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
   }
}
// The example displays the following output:
//       G: 21708
//       C: $21,708.00
//       D3: 21708
//       E2: 2.17E+004
//       e3: 2.171e+004
//       F: 21708.00
//       N: 21,708.00
//       P: 2,170,800.00 %
//       X: 54CC
//       000000.0: 021708.0
//       #.0: 21708.0
//       00000000;(0);**Zero**: 00021708

let value = 21708us
let specifiers = 
    [| "G"; "C"; "D3"; "E2"; "e3"; "F"
       "N"; "P"; "X"; "000000.0"; "#.0" 
       "00000000(0)**Zero**" |]

for specifier in specifiers do
    printfn $"{specifier}: {value.ToString specifier}"
// The example displays the following output:
//       G: 21708
//       C: $21,708.00
//       D3: 21708
//       E2: 2.17E+004
//       e3: 2.171e+004
//       F: 21708.00
//       N: 21,708.00
//       P: 2,170,800.00 %
//       X: 54CC
//       000000.0: 021708.0
//       #.0: 21708.0
//       00000000(0)**Zero**: 00021708

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As UShort = 21708 
      Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
                                     "N", "P", "X", "000000.0", "#.0", _
                                     "00000000;(0);**Zero**" }
      
      For Each specifier As String In specifiers
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
      Next
   End Sub
End Module
' The example displays the following output:
'       G: 21708
'       C: $21,708.00
'       D3: 21708
'       E2: 2.17E+004
'       e3: 2.171e+004
'       F: 21708.00
'       N: 21,708.00
'       P: 2,170,800.00 %
'       X: 54CC
'       000000.0: 021708.0
'       #.0: 21708.0
'       00000000;(0);**Zero**: 00021708

Opmerkingen

Met ToString(String) de methode wordt een UInt16 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 elke geldige standaardaanduiding voor numerieke notatie of een combinatie van aangepaste numerieke notatieaanduidingen zijn. Als format dit gelijk is aan String.Empty of is null, wordt de retourwaarde van het huidige UInt16 object opgemaakt met de algemene notatieaanduiding ('G'). Als format er een andere waarde is, genereert de methode een FormatException.

.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 ondersteuning voor opmaak in .NET.

De notatie van de geretourneerde tekenreeks wordt bepaald door het NumberFormatInfo object voor de huidige cultuur. Afhankelijk van de format parameter bepaalt dit object symbolen zoals het groepsscheidingsteken en het decimaalteken in de uitvoertekenreeks. Als u opmaakinformatie wilt opgeven voor andere culturen dan de huidige cultuur, roept u de ToString(String, IFormatProvider) overbelasting aan.

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, die bestaat uit een reeks cijfers tussen 0 en 9, zonder een teken of voorloopnullen.

Voorbeelden

In het volgende voorbeeld wordt een UInt16 waarde weergegeven met behulp van de standaardmethode ToString() . Ook worden de tekenreeksweergaven weergegeven van de UInt16 waarde die het resultaat is van het gebruik van enkele standaardnotatieaanduidingen. De voorbeelden worden weergegeven met behulp van de opmaakconventies van de en-US cultuur.

using System;

public class Example
{
   public static void Main()
   {
      ushort value = 16324;
      // Display value using default ToString method.
      Console.WriteLine(value.ToString());      
      Console.WriteLine();
      
      // Define an array of format specifiers.
      string[] formats = { "G", "C", "D", "F", "N", "X" };
      // Display value using the standard format specifiers.
      foreach (string format in formats)
         Console.WriteLine("{0} format specifier: {1,12}", 
                           format, value.ToString(format));         
   }
}
// The example displays the following output:
//       16324
//
//       G format specifier:        16324
//       C format specifier:   $16,324.00
//       D format specifier:        16324
//       F format specifier:     16324.00
//       N format specifier:    16,324.00
//       X format specifier:         3FC4

let value = 16324us
// Display value using default ToString method.
printfn $"{value.ToString()}\n"     

// Define an array of format specifiers.
let formats = [| "G"; "C"; "D"; "F"; "N"; "X" |]
// Display value using the standard format specifiers.
for format in formats do
    printfn $"{format} format specifier: {value.ToString format,12}" 
// The example displays the following output:
//       16324
//
//       G format specifier:        16324
//       C format specifier:   $16,324.00
//       D format specifier:        16324
//       F format specifier:     16324.00
//       N format specifier:    16,324.00
//       X format specifier:         3FC4

Module Example
   Public Sub Main()
      Dim value As UInt16 = 16324
      ' Display value using default ToString method.
      Console.WriteLine(value.ToString())            
      Console.WriteLine()
      
      ' Define an array of format specifiers.
      Dim formats() As String = { "G", "C", "D", "F", "N", "X" }
      ' Display value using the standard format specifiers.
      For Each format As String In formats
         Console.WriteLine("{0} format specifier: {1,12}", _
                           format, value.ToString(format))         
      Next
   End Sub
End Module
' The example displays the following output:
'       16324
'       
'       G format specifier:        16324
'       C format specifier:   $16,324.00
'       D format specifier:        16324
'       F format specifier:     16324.00
'       N format specifier:    16,324.00
'       X format specifier:         3FC4

Opmerkingen

Met ToString() de methode wordt een UInt16 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)

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?