Guid.IFormattable.ToString(String, IFormatProvider) Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает строковое представление значения этого экземпляра в соответствии с заданным описателем формата и сведениями об особенностях форматирования, связанных с языком и региональными параметрами.
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 -> stringFunction ToString (format As String, provider As IFormatProvider) As String Implements IFormattable.ToString- format
- String
Единственный спецификатор формата, указывающий, как следует отформатировать значение объекта Guid. Параметр format может принимать значения N, D, B, P или X. Если параметр format имеет значение NULL или равен пустой строке (""), используется значение "D".
- provider
- IFormatProvider
(Зарезервирован.) Объект, предоставляющий сведения о форматировании, связанные с определенным языком и региональными параметрами.
Значение данного объекта Guid, представленное в виде последовательности шестнадцатеричных цифр в нижнем регистре в указанном формате.
Значение параметра format не равно NULL, не является пустой строкой ("") или одним из следующих единичных описателей формата: "N", "D", "B", "P" или "X".
Параметр provider зарезервирован для использования в будущем и не способствует выполнению этого метода. Вы можете передать null вызов метода.
В следующей таблице показаны описатели принятого format формата для параметра. "0" представляет цифру; дефисы ("-"), фигурные скобки ("{", "}") и круглые скобки ("(", ")") отображаются, как показано ниже.
| Описатель | Формат возвращаемого значения |
|---|---|
N |
32 цифры: 00000000000000000000000000000000 |
D |
32 цифры, разделенные дефисами: 00000000-0000-0000-0000-000000000000 |
B |
32 цифры, разделенные дефисами, заключенные в фигурные скобки: {00000000-0000-0000-0000-000000000000} |
P |
32 цифры, разделенные дефисами, заключенные в круглые скобки: (00000000-0000-0000-0000-000000000000) |
X |
Четыре шестнадцатеричных значения, заключенные в фигурные скобки, где четвертое значение представляет собой подмножество из восьми шестнадцатеричных значений, которые также заключены в фигурные скобки: {0x00000000,0x0000,0x0000;{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}} |
Шестнадцатеричные цифры через f являются строчными в возвращаемой строке. Чтобы преобразовать их в верхний String.ToUpper регистр, вызовите метод в возвращаемой строке.
provider Так как параметр игнорируется, его нельзя использовать для предоставления настраиваемого решения форматирования. Чтобы представить Guid значение в виде строки в формате, который не поддерживается строками стандартного формата GUID, вызовите String.Format(IFormatProvider, String, Object[]) метод с provider объектом, реализующим и ICustomFormatter IFormatProvider интерфейсы. Дополнительные сведения см. в разделе "Настраиваемое форматирование с помощью ICustomFormatter" статьи " Типы форматирования ".
| Продукт | Версии |
|---|---|
| .NET | Core 1.0, Core 1.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6 |
| UWP | 10.0 |