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