Byte.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 waarde van het huidige Byte object naar de equivalente tekenreeksweergave.

Overloads

Name	Description
ToString(IFormatProvider)	Converteert de numerieke waarde van het huidige Byte object naar de equivalente tekenreeksweergave met behulp van de opgegeven cultuurspecifieke opmaakinformatie.
ToString(String, IFormatProvider)	Converteert de waarde van het huidige Byte object naar de equivalente tekenreeksweergave met behulp van de opgegeven opmaak en cultuurspecifieke opmaakinformatie.
ToString(String)	Converteert de waarde van het huidige Byte object naar de equivalente tekenreeksweergave met behulp van de opgegeven indeling.
ToString()	Converteert de waarde van het huidige Byte object naar de equivalente tekenreeksweergave.

ToString(IFormatProvider)

Converteert de numerieke waarde van het huidige Byte object naar de equivalente tekenreeksweergave met behulp van de opgegeven cultuurspecifieke opmaakinformatie.

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 object in de indeling die is opgegeven door de provider parameter.

Implementeringen

ToString(IFormatProvider)

Voorbeelden

In het volgende voorbeeld wordt een matrix met bytewaarden herhaald en worden deze allemaal weergegeven in de console door de ToString(IFormatProvider) methode aan te roepen met verschillende indelingsproviders.

byte[] bytes = {0, 1, 14, 168, 255};
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("de-de"),
                           new CultureInfo("es-es")};
foreach (byte byteValue in bytes)
{
   foreach (CultureInfo provider in providers)
      Console.Write("{0,3} ({1})      ",
                    byteValue.ToString(provider), provider.Name);

   Console.WriteLine();
}
// The example displays the following output to the console:
//      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
//      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
//     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
//    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
//    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

let bytes = [| 0; 1; 14; 168; 255 |]
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "de-de"
      CultureInfo "es-es" ]

for byteValue in bytes do
    for provider in providers do
        printf $"{byteValue.ToString provider,3} ({provider.Name})      " 

    printfn ""

// The example displays the following output to the console:
//      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
//      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
//     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
//    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
//    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

Dim bytes() As Byte = {0, 1, 14, 168, 255}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
For Each byteValue As Byte In bytes
   For Each provider As CultureInfo In providers
      Console.Write("{0,3} ({1})      ", byteValue.ToString(provider), provider.Name)
   Next
   Console.WriteLine()                                        
Next
' The example displays the following output to the console:
'      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
'      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
'     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
'    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
'    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

Opmerkingen

De retourwaarde is opgemaakt met de algemene numerieke notatieaanduiding ('G').

De provider parameter is een object dat de IFormatProvider interface implementeert. 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 een object niet null kan worden verkregenprovider, NumberFormatInfo wordt de retourwaarde opgemaakt met behulp van het NumberFormatInfo object voor de huidige threadcultuur. Zie voor meer informatie over de huidige threadcultuur Thread.CurrentCulture.

.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

ToString(String, IFormatProvider)

Converteert de waarde van het huidige Byte object naar de equivalente tekenreeksweergave met behulp van de opgegeven opmaak en cultuurspecifieke opmaakinformatie.

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 standaardtekenreeks of aangepaste numerieke notatie.

provider: IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie levert.

Retouren

String

De tekenreeksweergave van het huidige Byte object, opgemaakt zoals opgegeven door de format en provider parameters.

Implementeringen

ToString(String, IFormatProvider)

Uitzonderingen

FormatException

format bevat een niet-ondersteunde aanduiding. Ondersteunde opmaakaanduidingen worden weergegeven in de sectie Opmerkingen.

Voorbeelden

In het volgende voorbeeld wordt de standaardnotatietekenreeks N en vier verschillende CultureInfo objecten gebruikt om de tekenreeksweergave van een bytewaarde weer te geven aan de console.

byte byteValue = 250;
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("es-es"),
                           new CultureInfo("de-de")};

foreach (CultureInfo provider in providers)
   Console.WriteLine("{0} ({1})",
                     byteValue.ToString("N2", provider), provider.Name);
// The example displays the following output to the console:
//       250.00 (en-US)
//       250,00 (fr-FR)
//       250,00 (es-ES)
//       250,00 (de-DE)

let byteValue = 250uy
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "es-es"
      CultureInfo "de-de" ]

for provider in providers do
    printfn $"""{byteValue.ToString("N2", provider)} ({provider.Name})"""

// The example displays the following output to the console:
//       250.00 (en-US)
//       250,00 (fr-FR)
//       250,00 (es-ES)
//       250,00 (de-DE)

Dim byteValue As Byte = 250
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("es-es"), _
                                  New CultureInfo("de-de")} 
For Each provider As CultureInfo In providers 
   Console.WriteLine("{0} ({1})", _
                     byteValue.ToString("N2", provider), provider.Name)
Next   
' The example displays the following output to the console:
'       250.00 (en-US)
'       250,00 (fr-FR)
'       250,00 (es-ES)
'       250,00 (de-DE)

Opmerkingen

Met ToString(String, IFormatProvider) de methode wordt een Byte waarde opgemaakt in een opgegeven notatie van een opgegeven cultuur. Als u een getal wilt opmaken met behulp van de standaardnotatie ('G') van de huidige cultuur, roept u de ToString() methode aan. Als u een getal wilt opmaken met behulp van een opgegeven notatie van de huidige cultuur, roept u de ToString(String) methode aan.

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 lege tekenreeks ("") is null , wordt de retourwaarde van deze methode opgemaakt met de algemene numerieke notatieaanduiding ('G').

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.

.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

ToString(String)

Converteert de waarde van het huidige Byte object 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 het huidige Byte object, opgemaakt zoals opgegeven door de format parameter.

Uitzonderingen

FormatException

format bevat een niet-ondersteunde aanduiding. Ondersteunde opmaakaanduidingen worden weergegeven in de sectie Opmerkingen.

Voorbeelden

In het volgende voorbeeld wordt een Byte waarde geïnitialiseerd en weergegeven in de console met behulp van elk van de ondersteunde tekenreeksen voor standaardindelingen en een tekenreeks met aangepaste notatie. Het voorbeeld wordt uitgevoerd met en-US als de huidige cultuur.

string[] formats = {"C3", "D4", "e1", "E2", "F1", "G", "N1",
                    "P0", "X4", "0000.0000"};
byte number = 240;
foreach (string format in formats)
   Console.WriteLine("'{0}' format specifier: {1}",
                     format, number.ToString(format));

// The example displays the following output to the console if the
// current culture is en-us:
//       'C3' format specifier: $240.000
//       'D4' format specifier: 0240
//       'e1' format specifier: 2.4e+002
//       'E2' format specifier: 2.40E+002
//       'F1' format specifier: 240.0
//       'G' format specifier: 240
//       'N1' format specifier: 240.0
//       'P0' format specifier: 24,000 %
//       'X4' format specifier: 00F0
//       '0000.0000' format specifier: 0240.0000

let formats = 
    [ "C3"; "D4"; "e1"; "E2"; "F1"; "G"; "N1"
      "P0"; "X4"; "0000.0000" ]
let number = 240uy
for format in formats do
    printfn $"'{format}' format specifier: {number.ToString format}"

// The example displays the following output to the console if the
// current culture is en-us:
//       'C3' format specifier: $240.000
//       'D4' format specifier: 0240
//       'e1' format specifier: 2.4e+002
//       'E2' format specifier: 2.40E+002
//       'F1' format specifier: 240.0
//       'G' format specifier: 240
//       'N1' format specifier: 240.0
//       'P0' format specifier: 24,000 %
//       'X4' format specifier: 00F0
//       '0000.0000' format specifier: 0240.0000

Dim formats() As String = {"C3", "D4", "e1", "E2", "F1", "G", _
                           "N1", "P0", "X4", "0000.0000"}
Dim number As Byte = 240
For Each format As String In formats
   Console.WriteLine("'{0}' format specifier: {1}", _
                     format, number.ToString(format))
Next  
' The example displays the following output to the console if the
' current culture is en-us:
'       'C3' format specifier: $240.000
'       'D4' format specifier: 0240
'       'e1' format specifier: 2.4e+002
'       'E2' format specifier: 2.40E+002
'       'F1' format specifier: 240.0       
'       'G' format specifier: 240
'       'N1' format specifier: 240.0
'       'P0' format specifier: 24,000 %
'       'X4' format specifier: 00F0
'       '0000.0000' format specifier: 0240.0000

Opmerkingen

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 lege tekenreeks ("") is null , wordt de retourwaarde opgemaakt met de algemene numerieke notatieaanduiding ('G').

De retourwaarde van deze functie wordt opgemaakt met behulp van het NumberFormatInfo object voor de huidige threadcultuur. Zie voor meer informatie over de huidige threadcultuur Thread.CurrentCulture. Als u opmaakinformatie wilt opgeven voor andere culturen dan de huidige cultuur, roept u de Byte.ToString(String, IFormatProvider) methode aan.

.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

Procedure: Een getal opvulen met voorloopnullen

Van toepassing op

ToString()

Converteert de waarde van het huidige Byte object 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 object, die bestaat uit een reeks cijfers die variëren van 0 tot 9 zonder voorloopnullen.

Voorbeelden

In het volgende voorbeeld wordt een matrix met bytewaarden weergegeven. Houd er rekening mee dat de ToString() methode niet expliciet wordt aangeroepen in het voorbeeld. In plaats daarvan wordt het impliciet aangeroepen, vanwege het gebruik van de samengestelde opmaakfunctie , maakt het F#-voorbeeld gebruik van tekenreeksinterpolatie.

byte[] bytes = {0, 1, 14, 168, 255};
foreach (byte byteValue in bytes)
   Console.WriteLine(byteValue);
// The example displays the following output to the console if the current
// culture is en-US:
//       0
//       1
//       14
//       168
//       255

let bytes = [| 0; 1; 14; 168; 255 |]
for byteValue in bytes do
    printfn $"{byteValue}"

// The example displays the following output to the console if the current
// culture is en-US:
//       0
//       1
//       14
//       168
//       255

Dim bytes() As Byte = {0, 1, 14, 168, 255}
For Each byteValue As Byte In Bytes
   Console.WriteLine(byteValue)
Next   
' The example displays the following output to the console if the current
' culture is en-US:
'       0
'       1
'       14
'       168
'       255

Opmerkingen

De retourwaarde is opgemaakt met de algemene numerieke notatieaanduiding ('G') en het NumberFormatInfo object voor de huidige threadcultuur. Als u de opmaak van de tekenreeksweergave van de Byte waarde wilt definiëren, roept u de ToString methode aan. Als u zowel de notatieaanduidingen als cultuur wilt definiëren die worden gebruikt om de tekenreeksweergave van een Byte waarde te maken, roept u de ToString methode aan.

.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 voor meer informatie over de huidige threadcultuur Thread.CurrentCulture.

Van toepassing op

Feedback

Is deze pagina nuttig?