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