Guid.ToString Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает строковое представление значения данного экземпляра структуры Guid.
Перегрузки
ToString(String, IFormatProvider) |
Возвращает строковое представление значения этого экземпляра класса Guid в соответствии с заданным описателем формата и сведениями об особенностях форматирования, связанных с языком и региональными параметрами. |
ToString() |
Возвращает строковое представление значения этого экземпляра в формате реестра. |
ToString(String) |
Возвращает строковое представление значения этого экземпляра Guid в соответствии с заданным описателем формата. |
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. Если параметр format
имеет значение null
или равен пустой строке (""), используется значение 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}} |
Шестнадцатеричные цифры от a до f являются строчными в возвращаемой строке. Чтобы преобразовать их в верхний регистр, вызовите String.ToUpper метод в возвращаемой строке.
provider
Так как параметр игнорируется, его нельзя использовать для предоставления пользовательского решения форматирования. Чтобы представить Guid значение в виде строки в формате, который не поддерживается строками стандартного формата GUID, вызовите String.Format(IFormatProvider, String, Object[]) метод с provider
объектом , реализующим ICustomFormatter интерфейсы и IFormatProvider . Дополнительные сведения см. в разделе "Настраиваемое форматирование с помощью ICustomFormatter" статьи Типы форматирования .
Применяется к
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)
- Исходный код:
- 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. Если параметр format
имеет значение null
или равен пустой строке (""), используется значение 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}} |
Шестнадцатеричные цифры от a до f являются строчными в возвращаемой строке. Чтобы преобразовать их в верхний регистр, вызовите String.ToUpper метод в возвращаемой строке.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по