Guid.ToString Метод

Определение

Возвращает строковое представление значения данного экземпляра структуры Guid.

Перегрузки

ToString()

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

ToString(String)

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

ToString(String, IFormatProvider)

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

ToString()

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

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

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

String

Значение этого Guid, отформатированное с помощью описателя формата "D" следующим образом: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

где значение GUID представлено в виде последовательности шестнадцатеричных цифр в нижнем регистре, сгруппированных по 8, 4, 4, 4 и 12 цифр и разделенных дефисами. В данном случае возвращаемое значение таково: "382c74c3-721d-4f34-80e5-57657b6cbc27". Для преобразования шестнадцатеричных цифр из строчных f в прописные буквы вызовите метод ToUpper() в возвращаемую строку.

Комментарии

Этот метод предоставляет формат GUID по умолчанию, который достаточно для обычного использования. Однако другие версии этого метода, принимающие параметр, format предоставляют несколько общих вариантов форматирования.

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

ToString(String)

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

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Параметры

format
String

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

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

String

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

Исключения

Значением 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}}

Шестнадцатеричные цифры от a до f являются строчными в возвращаемой строке. Чтобы преобразовать их в верхний регистр, вызовите String.ToUpper метод для возвращаемой строки.

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

ToString(String, IFormatProvider)

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

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string? format, IFormatProvider? provider);
public string ToString (string format, IFormatProvider provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Параметры

format
String

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

provider
IFormatProvider

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

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

String

Значение данного 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}}

Шестнадцатеричные цифры от a до f являются строчными в возвращаемой строке. Чтобы преобразовать их в верхний регистр, вызовите String.ToUpper метод для возвращаемой строки.

Поскольку provider параметр игнорируется, его нельзя использовать для предоставления пользовательского решения форматирования. Чтобы представить Guid значение в виде строки в формате, который не поддерживается строками стандартного формата GUID, вызовите String.Format(IFormatProvider, String, Object[]) метод с помощью provider объекта, который реализует ICustomFormatter IFormatProvider интерфейсы и. Дополнительные сведения см. в подразделе "настраиваемое форматирование с помощью ICustomFormatter" статьи Типы форматирования .

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