Guid.ToString Metoda

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Vrátí řetězcovou reprezentaci hodnoty této instance Guid struktury.

Přetížení

Name	Description
ToString(String)	Vrátí řetězcovou reprezentaci hodnoty této Guid instance podle zadaného specifikátoru formátu.
ToString()	Vrátí řetězcovou reprezentaci hodnoty této instance ve formátu registru.
ToString(String, IFormatProvider)	Vrátí řetězcovou reprezentaci hodnoty této instance Guid třídy podle zadaného specifikátoru formátu a informací o formátu specifickém pro jazykovou verzi.

ToString(String)

Zdroj:

Guid.cs

Vrátí řetězcovou reprezentaci hodnoty této Guid instance podle zadaného specifikátoru formátu.

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

Parametry

format

String

Specifikátor jednoho formátu, který označuje, jak formátovat hodnotu tohoto Guidformátu . Parametrem format může být "N", "D", "B", "P" nebo "X". Pokud format je nebo je null prázdný řetězec (""), použije se "D".

Návraty

String

Hodnota tohoto Guid, reprezentovaná jako řada malých šestnáctkových číslic v zadaném formátu.

Výjimky

FormatException

Hodnota format není null, prázdný řetězec (""), "N", "D", "B", "P" nebo "X".

Poznámky

Následující tabulka ukazuje specifikátory přijatého format formátu pro parametr. "0" představuje číslici; Spojovníky ("-"), složené závorky ("{", "}") a závorky ("("; ")") se zobrazí, jak je znázorněno.

Specifikátor	Formát návratové hodnoty
N	32 číslic: 00000000000000000000000000000000
D	32 číslic oddělených pomlčkami: 00000000-0000-0000-0000-000000000000
B	32 číslic oddělených pomlčkami, uzavřených ve složených závorkách: {00000000-0000-0000-0000-000000000000}
P	32 číslic oddělených pomlčkami v závorkách: (00000000-0000-0000-0000-000000000000)
X	Čtyři šestnáctkové hodnoty uzavřené ve složených závorkách, kde čtvrtá hodnota je podmnožinou osmi šestnáctkových hodnot, které jsou také uzavřeny ve složených závorkách: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Šestnáctkové číslice a až f jsou ve vráceném řetězci malými písmeny. Chcete-li je převést na velká písmena, zavolejte String.ToUpper metodu vráceného řetězce.

ToString()

Zdroj:

Guid.cs

Vrátí řetězcovou reprezentaci hodnoty této instance ve formátu registru.

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

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Návraty

String

Hodnota tohoto Guidformátu , formátovaná pomocí specifikátoru formátu "D" následujícím způsobem:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

kde je hodnota identifikátoru GUID reprezentována jako řada šestnáctkových číslic malými písmeny ve skupinách 8, 4, 4, 4, 4 a 12 číslic a oddělených spojovníky. Příkladem návratové hodnoty je "382c74c3-721d-4f34-80e5-57657b6cbc27". Chcete-li převést šestnáctkové číslice z a až f na velká písmena, zavolejte ToUpper() metodu vráceného řetězce.

Poznámky

Tato metoda poskytuje výchozí formát GUID, který je dostatečný pro typické použití; Jiné verze této metody, které přebírají format parametr, však poskytují několik běžných variant formátu.

ToString(String, IFormatProvider)

Zdroj:

Guid.cs

Vrátí řetězcovou reprezentaci hodnoty této instance Guid třídy podle zadaného specifikátoru formátu a informací o formátu specifickém pro jazykovou verzi.

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

Parametry

format

String

Specifikátor jednoho formátu, který označuje, jak formátovat hodnotu tohoto Guidformátu . Parametrem format může být "N", "D", "B", "P" nebo "X". Pokud format je nebo je null prázdný řetězec (""), použije se "D".

provider

IFormatProvider

(Vyhrazeno) Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

String

Hodnota tohoto Guid, reprezentovaná jako řada malých šestnáctkových číslic v zadaném formátu.

Implementuje

ToString(String, IFormatProvider)

Výjimky

FormatException

Hodnota format není null, prázdný řetězec (""), "N", "D", "B", "P" nebo "X".

Poznámky

Parametr provider je vyhrazen pro budoucí použití a nepřispívá k provádění této metody. Volání metody můžete předat null .

Následující tabulka ukazuje specifikátory přijatého format formátu pro parametr. "0" představuje číslici; Spojovníky ("-"), složené závorky ("{", "}") a závorky ("("; ")") se zobrazí, jak je znázorněno.

Specifikátor	Formát návratové hodnoty
N	32 číslic: 00000000000000000000000000000000
D	32 číslic oddělených pomlčkami: 00000000-0000-0000-0000-000000000000
B	32 číslic oddělených pomlčkami, uzavřených ve složených závorkách: {00000000-0000-0000-0000-000000000000}
P	32 číslic oddělených pomlčkami v závorkách: (00000000-0000-0000-0000-000000000000)
X	Čtyři šestnáctkové hodnoty uzavřené ve složených závorkách, kde čtvrtá hodnota je podmnožinou osmi šestnáctkových hodnot, které jsou také uzavřeny ve složených závorkách: {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Šestnáctkové číslice a až f jsou ve vráceném řetězci malými písmeny. Chcete-li je převést na velká písmena, zavolejte String.ToUpper metodu vráceného řetězce.

Vzhledem k tomu, že je provider parametr ignorován, nemůžete ho použít k poskytnutí vlastního řešení formátování. Chcete-li reprezentovat Guid hodnotu jako řetězec ve formátu, který není podporován standardními řetězci formátu GUID, zavolejte String.Format(IFormatProvider, String, Object[]) metodu provider s objektem, který implementuje obě ICustomFormatter rozhraní i IFormatProvider rozhraní. Další informace naleznete v části Vlastní formátování pomocí ICustomFormatter v článku Typy formátování .