Guid.ToString Метод

Определение

Пространство имен:
System
Сборки:
mscorlib.dll, System.Runtime.dll
Сборки:
netstandard.dll, System.Runtime.dll
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

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

Перегрузки

Имя Описание
ToString(String)

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

Возвращает строковое представление значения этого экземпляра в формате реестра.
ToString(String, IFormatProvider)

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

ToString(String)

Исходный код:
Guid.cs
Исходный код:
Guid.cs
Исходный код:
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".

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

String

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

Исключения

FormatException

Значение 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
Исходный код:
Guid.cs
Исходный код:
Guid.cs

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

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, IFormatProvider)

Исходный код:
Guid.cs
Исходный код:
Guid.cs
Исходный код:
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

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

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

String

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

Реализации

ToString(String, IFormatProvider)

Исключения

FormatException

Значение 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" статьи "Типы форматирования ".

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