Guid.IFormattable.ToString(String, IFormatProvider) Metoda
Definice
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
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í .