Поделиться через

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".

Комментарии

Параметр 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" статьи " Типы форматирования ".

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