Guid.ToString Метод

Определение

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

Перегрузки

ToString(String)

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

ToString()

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

ToString(String, IFormatProvider)

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

ToString(String)

Исходный код:
Guid.cs
Исходный код:
Guid.cs
Исходный код:
Guid.cs

Возвращает строковое представление значения этого 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". Если formatnull или используется пустая строка (""), "D".

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

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

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

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

ToString()

Исходный код:
Guid.cs
Исходный код:
Guid.cs
Исходный код:
Guid.cs

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

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As 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, IFormatProvider)

Исходный код:
Guid.cs
Исходный код:
Guid.cs
Исходный код:
Guid.cs

Возвращает строковое представление значения этого экземпляра класса 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". Если formatnull или используется пустая строка (""), "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" статьи типов форматирования.

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