Sdílet prostřednictvím


Guid.IFormattable.ToString(String, IFormatProvider) Metoda

Definice

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

 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

Parametry

format
String

Specifikátor jednoho formátu, který označuje, jak formátovat hodnotu Guid. Parametr format může být "N", "D", "B", "P" nebo "X". Pokud format je hodnota null 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 čísla reprezentovaná jako řada malých šestnáctkových číslic v zadaném formátu.

Implementuje

Výjimky

Hodnota format není null, prázdný řetězec ("") nebo jeden z následujících specifikátorů s jedním formátem:"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; pomlčky ("-"), složené závorky ("{", "}") a kulaté závorky ("(",")") vypadají tak, jak jsou vyobrazeny.

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 a uzavřených ve složených závorkách:

{00000000-0000-0000-0000-000000000000}
P 32 číslic oddělených pomlčkami a uzavřených v kulatých závorkách:

(00000000-0000-0000-0000-000000000000)
X Čtyři šestnáctkové hodnoty uzavřené ve složených závorkách, přičemž čtvrtá hodnota je podmnožinu osmi šestnáctkových hodnot uzavřených rovněž 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á písmena. Chcete-li je převést na velká písmena, zavolejte metodu String.ToUpper na vrácený řetězec.

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 jak rozhraní ICustomFormatter IFormatProvider , tak i rozhraní. Další informace najdete v části Vlastní formátování pomocí ICustomFormatter v článku Typy formátování .

Platí pro