Guid.ToString Methode

Definitie

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

Retourneert een tekenreeksweergave van de waarde van dit exemplaar van de Guid structuur.

Overloads

Name Description
ToString(String)

Retourneert een tekenreeksweergave van de waarde van dit Guid exemplaar, volgens de opgegeven indelingsaanduiding.
ToString()

Retourneert een tekenreeksweergave van de waarde van dit exemplaar in registerindeling.
ToString(String, IFormatProvider)

Retourneert een tekenreeksweergave van de waarde van dit exemplaar van de Guid klasse, volgens de opgegeven notatieaanduiding en cultuurspecifieke notatiegegevens.

ToString(String)

Bron:
Guid.cs
Bron:
Guid.cs
Bron:
Guid.cs
Bron:
Guid.cs
Bron:
Guid.cs

Retourneert een tekenreeksweergave van de waarde van dit Guid exemplaar, volgens de opgegeven indelingsaanduiding.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString(string format);
public string ToString(string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parameters

format
String

Eén notatieaanduiding die aangeeft hoe de waarde van deze Guidindeling moet worden opgemaakt. De format parameter kan 'N', 'D', 'B', 'P' of 'X' zijn. Als format dit een null of een lege tekenreeks (""), wordt "D" gebruikt.

Retouren

String

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

Uitzonderingen

FormatException

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

Opmerkingen

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.

Van toepassing op

ToString()

Bron:
Guid.cs
Bron:
Guid.cs
Bron:
Guid.cs
Bron:
Guid.cs
Bron:
Guid.cs

Retourneert een tekenreeksweergave van de waarde van dit exemplaar in registerindeling.

public:
 override System::String ^ ToString();
public override string ToString();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Retouren

String

De waarde van deze Guidindeling, opgemaakt met behulp van de notatieaanduiding D, als volgt:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

waarbij de waarde van de GUID wordt weergegeven als een reeks hexadecimale cijfers in kleine letters in groepen van 8, 4, 4, 4 en 12 cijfers en gescheiden door afbreekstreepjes. Een voorbeeld van een retourwaarde is '382c74c3-721d-4f34-80e5-57657b6cbc27'. Als u de hexadecimale cijfers van een tot en met f naar hoofdletters wilt converteren, roept u de ToUpper() methode op de geretourneerde tekenreeks aan.

Opmerkingen

Deze methode biedt een standaard-GUID-indeling die voldoende is voor normaal gebruik; Andere versies van deze methode die een format parameter gebruiken, bieden echter enkele algemene indelingsvariaties.

Van toepassing op

ToString(String, IFormatProvider)

Bron:
Guid.cs
Bron:
Guid.cs
Bron:
Guid.cs
Bron:
Guid.cs
Bron:
Guid.cs

Retourneert een tekenreeksweergave van de waarde van dit exemplaar van de Guid klasse, volgens de opgegeven notatieaanduiding en cultuurspecifieke notatiegegevens.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString(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

Eén notatieaanduiding die aangeeft hoe de waarde van deze Guidindeling moet worden opgemaakt. De format parameter kan 'N', 'D', 'B', 'P' of 'X' zijn. Als format dit een null of een lege tekenreeks (""), wordt "D" gebruikt.

provider
IFormatProvider

(Gereserveerd) Een object dat cultuurspecifieke opmaakinformatie levert.

Retouren

String

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

Implementeringen

ToString(String, IFormatProvider)

Uitzonderingen

FormatException

De waarde is format niet null, een lege tekenreeks (""), "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