Guid.IFormattable.ToString(String, IFormatProvider) Метод

Ссылка

Определение

Пространство имен:: System

Сборка:: System.Runtime.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает строковое представление значения этого экземпляра в соответствии с заданным описателем формата и сведениями об особенностях форматирования, связанных с языком и региональными параметрами.

 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

Параметры

format: String

Единственный спецификатор формата, указывающий, как следует отформатировать значение объекта Guid. Параметр format может принимать значения N, D, B, P или X. Если параметр format имеет значение NULL или равен пустой строке (""), используется значение "D".

provider: IFormatProvider

(Зарезервирован.) Объект, предоставляющий сведения о форматировании, связанные с определенным языком и региональными параметрами.

Возвращаемое значение

String

Значение данного объекта Guid, представленное в виде последовательности шестнадцатеричных цифр в нижнем регистре в указанном формате.

Реализации

ToString(String, IFormatProvider)

Исключения

FormatException

Значение параметра format не равно NULL, не является пустой строкой ("") или одним из следующих единичных описателей формата: "N", "D", "B", "P" или "X".

В следующей таблице показаны описатели принятого 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" статьи " Типы форматирования ".

Применяется к