Guid.IFormattable.ToString(String, IFormatProvider) Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

ToString(String, IFormatProvider)

Výjimky

FormatException

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