Guid.TryParse Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid) |
Пытается проанализировать диапазон символов в значение. |
TryParse(String, IFormatProvider, Guid) |
Пытается проанализировать строку в значение. |
TryParse(ReadOnlySpan<Char>, Guid) |
Преобразует указанный диапазон символов только для чтения, содержащий представление GUID, в эквивалентную структуру Guid. |
TryParse(String, Guid) |
Преобразовывает строковое представление объекта GUID в эквивалентную структуру Guid. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)
- Исходный код:
- Guid.cs
- Исходный код:
- Guid.cs
- Исходный код:
- Guid.cs
Пытается проанализировать диапазон символов в значение.
public:
static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = ISpanParsable<Guid>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out Guid result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * Guid -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Guid) As Boolean
Параметры
- s
- ReadOnlySpan<Char>
Диапазон символов для анализа.
- provider
- IFormatProvider
Объект, предоставляющий сведения о форматировании параметра s
в зависимости от языка и региональных параметров.
- result
- Guid
При возврате этим методом содержит результат успешного анализа s
или неопределенное значение при сбое.
Возвращаемое значение
true
Значение , если s
анализ выполнен успешно; в противном случае — значение false
.
Применяется к
TryParse(String, IFormatProvider, Guid)
- Исходный код:
- Guid.cs
- Исходный код:
- Guid.cs
- Исходный код:
- Guid.cs
Пытается проанализировать строку в значение.
public:
static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = IParsable<Guid>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out Guid result);
static member TryParse : string * IFormatProvider * Guid -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Guid) As Boolean
Параметры
- s
- String
Строка для анализа.
- provider
- IFormatProvider
Объект, предоставляющий сведения о форматировании параметра s
в зависимости от языка и региональных параметров.
- result
- Guid
При возврате этого метода содержит результат успешного анализа s
или неопределенное значение при сбое.
Возвращаемое значение
true
Значение , если s
анализ выполнен успешно; в противном случае — значение false
.
Применяется к
TryParse(ReadOnlySpan<Char>, Guid)
- Исходный код:
- Guid.cs
- Исходный код:
- Guid.cs
- Исходный код:
- Guid.cs
Преобразует указанный диапазон символов только для чтения, содержащий представление GUID, в эквивалентную структуру Guid.
public:
static bool TryParse(ReadOnlySpan<char> input, [Runtime::InteropServices::Out] Guid % result);
public static bool TryParse (ReadOnlySpan<char> input, out Guid result);
static member TryParse : ReadOnlySpan<char> * Guid -> bool
Public Shared Function TryParse (input As ReadOnlySpan(Of Char), ByRef result As Guid) As Boolean
Параметры
- input
- ReadOnlySpan<Char>
Диапазон, содержащий символы, которые представляют идентификатор GUID для преобразования.
- result
- Guid
Когда этот метод возвращает данные, содержит преобразуемое значение. Если метод возвращает значение true
, то свойство result
содержит допустимое Guid. Если метод возвращает false
, result
равен Empty.
Возвращаемое значение
Значение true
, если синтаксический анализ выполнен успешно; в противном случае — значение false
.
Применяется к
TryParse(String, Guid)
- Исходный код:
- Guid.cs
- Исходный код:
- Guid.cs
- Исходный код:
- Guid.cs
Преобразовывает строковое представление объекта GUID в эквивалентную структуру Guid.
public:
static bool TryParse(System::String ^ input, [Runtime::InteropServices::Out] Guid % result);
public static bool TryParse (string input, out Guid result);
public static bool TryParse (string? input, out Guid result);
static member TryParse : string * Guid -> bool
Public Shared Function TryParse (input As String, ByRef result As Guid) As Boolean
Параметры
- input
- String
Строка, содержащая идентификатор GUID для преобразования.
- result
- Guid
Когда этот метод возвращает данные, содержит преобразуемое значение. Если метод возвращает значение true
, то свойство result
содержит допустимое Guid. Если метод возвращает false
, result
равен Empty.
Возвращаемое значение
Значение true
, если синтаксический анализ выполнен успешно; в противном случае — значение false
.
Примеры
В следующем примере создается новый ИДЕНТИФИКАТОР GUID, он преобразуется в три отдельных строковых представления путем вызова ToString(String) метода с описателями формата "B", "D" и "X", а затем вызывается TryParse метод для преобразования строк обратно в Guid значения.
Guid originalGuid = Guid.NewGuid();
// Create an array of string representations of the GUID.
string[] stringGuids = { originalGuid.ToString("B"),
originalGuid.ToString("D"),
originalGuid.ToString("X") };
// Parse each string representation.
foreach (var stringGuid in stringGuids)
{
if (Guid.TryParse(stringGuid, out var newGuid))
Console.WriteLine($"Converted {stringGuid} to a Guid");
else
Console.WriteLine($"Unable to convert {stringGuid} to a Guid");
}
// The example displays output similar to the following:
//
// Converted {81a130d2-502f-4cf1-a376-63edeb000e9f} to a Guid
// Converted 81a130d2-502f-4cf1-a376-63edeb000e9f to a Guid
// Converted {0x81a130d2,0x502f,0x4cf1,{0xa3,0x76,0x63,0xed,0xeb,0x00,0x0e,0x9f}} to a Guid
open System
let originalGuid = Guid.NewGuid()
// Create an array of string representations of the GUID.
let stringGuids =
[| originalGuid.ToString "B"
originalGuid.ToString "D"
originalGuid.ToString "X" |]
// Parse each string representation.
for stringGuid in stringGuids do
match Guid.TryParse stringGuid with
| true, newGuid ->
printfn $"Converted {stringGuid} to a Guid"
| _ ->
printfn $"Unable to convert {stringGuid} to a Guid"
// The example displays output similar to the following:
//
// Converted {81a130d2-502f-4cf1-a376-63edeb000e9f} to a Guid
// Converted 81a130d2-502f-4cf1-a376-63edeb000e9f to a Guid
// Converted {0x81a130d2,0x502f,0x4cf1,{0xa3,0x76,0x63,0xed,0xeb,0x00,0x0e,0x9f}} to a Guid
Module Example
Public Sub Main()
Dim originalGuid As Guid = Guid.NewGuid()
' Create an array of string representations of the GUID.
Dim stringGuids() As String = { originalGuid.ToString("B"),
originalGuid.ToString("D"),
originalGuid.ToString("X") }
' Parse each string representation.
Dim newGuid As Guid
For Each stringGuid In stringGuids
If Guid.TryParse(stringGuid, newGuid) Then
Console.WriteLine("Converted {0} to a Guid", stringGuid)
Else
Console.WriteLine("Unable to convert {0} to a Guid",
stringGuid)
End If
Next
End Sub
End Module
' The example displays the following output:
' Converted {81a130d2-502f-4cf1-a376-63edeb000e9f} to a Guid
' Converted 81a130d2-502f-4cf1-a376-63edeb000e9f to a Guid
' Converted {0x81a130d2,0x502f,0x4cf1,{0xa3,0x76,0x63,0xed,0xeb,0x00,0x0e,0x9f}} to a Guid
Комментарии
Этот метод похож на Parse метод , за исключением того, что вместо возврата проанализированного GUID он возвращает false
значение , если input
имеет null
или нет распознанный формат, и не создает исключение. Он обрезает все начальные или конечные пробелы из input
и преобразует строки в любом из пяти форматов, распознаваемых методами ToString(String) и ToString(String, IFormatProvider) , как показано в следующей таблице.
Описатель | Описание | Формат |
---|---|---|
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}} |
См. также раздел
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по