Guid.ToString Metoda

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

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

Přetížení

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
Zdroj:
Guid.cs
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);
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 Guid. Parametr format může být "N", "D", "B", "P" nebo "X". Pokud je formatnull nebo 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 formátu pro parametr format. "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 metodu String.ToUpper vráceného řetězce.

Platí pro

ToString()

Zdroj:
Guid.cs
Zdroj:
Guid.cs
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átovaného 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 metodu ToUpper() 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é berou format parametr poskytují několik běžných variant formátu.

Platí pro

ToString(String, IFormatProvider)

Zdroj:
Guid.cs
Zdroj:
Guid.cs
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);
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 Guid. Parametr format může být "N", "D", "B", "P" nebo "X". Pokud je formatnull nebo 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. Do volání metody můžete předat null.

Následující tabulka ukazuje specifikátory přijatého formátu pro parametr format. "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 metodu String.ToUpper vráceného řetězce.

Vzhledem k tomu, že parametr provider je 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 metodu String.Format(IFormatProvider, String, Object[]) s objektem provider, který implementuje rozhraní ICustomFormatter i IFormatProvider. Další informace najdete v části Vlastní formátování pomocí ICustomFormatter v článku Typy formátování.

Platí pro