Guid.IFormattable.ToString(String, IFormatProvider) Methode

Definitie

Retourneert een tekenreeksweergave van de waarde van dit exemplaar, volgens de opgegeven indelingsaanduiding en cultuurspecifieke notatiegegevens.

 virtual System::String ^ System.IFormattable.ToString(System::String ^ format, IFormatProvider ^ provider) = IFormattable::ToString;
string IFormattable.ToString(string format, IFormatProvider provider);
abstract member System.IFormattable.ToString : string * IFormatProvider -> string
override this.System.IFormattable.ToString : string * IFormatProvider -> string
Function ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToString

Parameters

format
String

Een enkele notatieaanduiding die aangeeft hoe de waarde van de Guid. De format parameter kan 'N', 'D', 'B', 'P' of 'X' zijn. Als format null is of een lege tekenreeks (""), wordt 'D' gebruikt.

provider
IFormatProvider

(Gereserveerd) Een object dat cultuurspecifieke opmaakinformatie levert.

Retouren

De waarde hiervan Guid wordt weergegeven als een reeks hexadecimale cijfers in kleine letters in de opgegeven notatie.

Implementeringen

Uitzonderingen

De waarde format is niet null, een lege tekenreeks ("") of een van de volgende notatieaanduidingen:"N", "D", "B", "P" of "X".

Opmerkingen

De provider parameter is gereserveerd voor toekomstig gebruik en draagt niet bij aan de uitvoering van deze methode. U kunt de methode-aanroep doorgeven null .

In de volgende tabel ziet u de geaccepteerde notatieaanduidingen voor de format parameter. "0" vertegenwoordigt een cijfer; afbreekstreepjes ("-"), accolades ("{", "}") en haakjes ("(", ")) worden weergegeven zoals weergegeven.

Specificator Indeling van retourwaarde
N 32 cijfers:

00000000000000000000000000000000
D 32 cijfers gescheiden door afbreekstreepjes:

00000000-0000-0000-0000-000000000000
B 32 cijfers gescheiden door afbreekstreepjes, tussen accolades:

{00000000-0000-0000-0000-000000000000}
P 32 cijfers gescheiden door afbreekstreepjes, tussen haakjes:

(00000000-0000-0000-0000-000000000000)
X Vier hexadecimale waarden tussen accolades, waarbij de vierde waarde een subset is van acht hexadecimale waarden die ook tussen accolades zijn opgenomen:

{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

De hexadecimale cijfers a tot en met f zijn kleine letters in de geretourneerde tekenreeks. Als u ze wilt converteren naar hoofdletters, roept u de String.ToUpper methode op de geretourneerde tekenreeks aan.

Omdat de provider parameter wordt genegeerd, kunt u deze niet gebruiken om een aangepaste opmaakoplossing te bieden. Als u een Guid waarde wilt weergeven als een tekenreeks in een indeling die niet wordt ondersteund door de standaard-GUID-indelingstekenreeksen, roept u de String.Format(IFormatProvider, String, Object[]) methode aan met een provider object dat zowel de ICustomFormatter als IFormatProvider de interfaces implementeert. Zie de sectie Aangepaste opmaak met ICustomFormatter in het artikel Opmaaktypen voor meer informatie.

Van toepassing op