Guid.Parse Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
Parse(String, IFormatProvider) |
Analysiert eine Zeichenfolge in einen Wert. |
Parse(ReadOnlySpan<Char>, IFormatProvider) |
Analysiert eine Spanne von Zeichen in einen Wert. |
Parse(ReadOnlySpan<Char>) |
Konvertiert eine schreibgeschützte Zeichenspanne, die eine GUID darstellt, in die entsprechende Guid-Struktur. |
Parse(String) |
Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid-Struktur. |
Parse(String, IFormatProvider)
- Quelle:
- Guid.cs
- Quelle:
- Guid.cs
- Quelle:
- Guid.cs
Analysiert eine Zeichenfolge in einen Wert.
public:
static Guid Parse(System::String ^ s, IFormatProvider ^ provider) = IParsable<Guid>::Parse;
public static Guid Parse (string s, IFormatProvider? provider);
static member Parse : string * IFormatProvider -> Guid
Public Shared Function Parse (s As String, provider As IFormatProvider) As Guid
Parameter
- s
- String
Die zu analysierende Zeichenfolge.
- provider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen zu s
bereitstellt.
Gibt zurück
Das Ergebnis der Analyse s
.
Implementiert
Gilt für:
Parse(ReadOnlySpan<Char>, IFormatProvider)
- Quelle:
- Guid.cs
- Quelle:
- Guid.cs
- Quelle:
- Guid.cs
Analysiert eine Spanne von Zeichen in einen Wert.
public:
static Guid Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<Guid>::Parse;
public static Guid Parse (ReadOnlySpan<char> s, IFormatProvider? provider);
static member Parse : ReadOnlySpan<char> * IFormatProvider -> Guid
Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As Guid
Parameter
- s
- ReadOnlySpan<Char>
Die Spanne der zu analysierenden Zeichen.
- provider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen zu s
bereitstellt.
Gibt zurück
Das Ergebnis der Analyse s
.
Implementiert
Gilt für:
Parse(ReadOnlySpan<Char>)
- Quelle:
- Guid.cs
- Quelle:
- Guid.cs
- Quelle:
- Guid.cs
Konvertiert eine schreibgeschützte Zeichenspanne, die eine GUID darstellt, in die entsprechende Guid-Struktur.
public:
static Guid Parse(ReadOnlySpan<char> input);
public static Guid Parse (ReadOnlySpan<char> input);
static member Parse : ReadOnlySpan<char> -> Guid
Public Shared Function Parse (input As ReadOnlySpan(Of Char)) As Guid
Parameter
- input
- ReadOnlySpan<Char>
Eine schreibgeschützte Spanne, die die Bytes enthält, die eine GUID darstellen.
Gibt zurück
Eine Struktur, die den analysierten Wert enthält.
Ausnahmen
Das Format von input
wurde nicht erkannt.
- oder -
Nach dem Kürzen beträgt die Länge der schreibgeschützten Zeichenspanne 0.
Hinweise
Die Parse -Methode schneidet alle führenden oder nachfolgenden Leerzeichen ab input
und konvertiert die restlichen Zeichen in input
einen Guid Wert. Diese Methode kann eine Zeichenspanne konvertieren, die eines der fünf von den ToString Methoden erzeugten Formate darstellt, wie in der folgenden Tabelle gezeigt.
Bezeichner | Beschreibung | Format |
---|---|---|
N |
32 Hexadezimalstellen | 00000000000000000000000000000000 |
D |
32 hexadezimale Ziffern durch Bindestriche getrennt | 00000000-0000-0000-0000-000000000000 |
B |
32 hexadezimale Ziffern getrennt durch Bindestriche, in Klammern eingeschlossen | {00000000-0000-0000-0000-000000000000} |
P |
32 hexadezimale Ziffern getrennt durch Bindestriche, in Klammern eingeschlossen | (00000000-0000-0000-0000-000000000000) |
X |
Vier hexadezimale Werte, die in Klammern eingeschlossen sind, wobei der vierte Wert eine Teilmenge von acht Hexadezimalwerten ist, die auch in Klammern eingeschlossen sind | {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}} |
Die -Methode löst ein aus FormatException , wenn die Zeichenfolge nicht erfolgreich analysiert werden kann. Gründe hierfür sind u. a.:
input
enthält Zeichen, die nicht Teil des Hexadezimalzeichensatzes sind.input
hat zu viele oder zu wenige Zeichen.input
befindet sich nicht in einem der von der ToString -Methode erkannten Und in der vorherigen Tabelle aufgeführten Formate.
Verwenden Sie die TryParse -Methode, um alle nicht erfolgreichen Analysevorgänge abzufangen, ohne eine Ausnahme behandeln zu müssen.
Gilt für:
Parse(String)
- Quelle:
- Guid.cs
- Quelle:
- Guid.cs
- Quelle:
- Guid.cs
Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid-Struktur.
public:
static Guid Parse(System::String ^ input);
public static Guid Parse (string input);
static member Parse : string -> Guid
Public Shared Function Parse (input As String) As Guid
Parameter
- input
- String
Die zu konvertierende Zeichenfolge.
Gibt zurück
Eine Struktur, die den analysierten Wert enthält.
Ausnahmen
input
ist null
.
Das Format von input
wurde nicht erkannt.
Beispiele
Im folgenden Beispiel wird eine neue GUID erstellt, sie in drei separate Zeichenfolgendarstellungen konvertiert, indem die -Methode mit den ToString(String) Formatbezeichnern "B", "D" und "X" aufgerufen wird, und dann die Parse -Methode aufruft, um die Zeichenfolgen wieder in Werte zu Guid konvertieren.
var 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)
{
try
{
Guid newGuid = Guid.Parse(stringGuid);
Console.WriteLine($"Converted {stringGuid} to a Guid");
}
catch (ArgumentNullException)
{
Console.WriteLine("The string to be parsed is null.");
}
catch (FormatException)
{
Console.WriteLine($"Bad format: {stringGuid}");
}
}
// 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
try
let newGuid = Guid.Parse stringGuid
printfn $"Converted {stringGuid} to a Guid"
with
| :? ArgumentNullException ->
printfn "The string to be parsed is null."
| :? FormatException ->
printfn $"Bad format: {stringGuid}"
// 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.
For Each stringGuid In stringGuids
Try
Dim newGuid As Guid = Guid.Parse(stringGuid)
Console.WriteLine("Converted {0} to a Guid", stringGuid)
Catch e As ArgumentNullException
Console.WriteLine("The string to be parsed is null.")
Catch e As FormatException
Console.WriteLine("Bad format: {0}", stringGuid)
End Try
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
Hinweise
Die Parse -Methode schneidet alle führenden oder nachfolgenden Leerzeichen ab input
und konvertiert die Zeichenfolgendarstellung einer GUID in einen Guid Wert. Diese Methode kann Zeichenfolgen in eines der fünf Formate konvertieren, die von den ToString(String) Methoden und ToString(String, IFormatProvider) erzeugt werden, wie in der folgenden Tabelle dargestellt.
Bezeichner | Beschreibung | Format |
---|---|---|
N |
32 Hexadezimalstellen | 00000000000000000000000000000000 |
D |
32 hexadezimale Ziffern durch Bindestriche getrennt | 00000000-0000-0000-0000-000000000000 |
B |
32 hexadezimale Ziffern getrennt durch Bindestriche, in Klammern eingeschlossen | {00000000-0000-0000-0000-000000000000} |
P |
32 hexadezimale Ziffern getrennt durch Bindestriche, in Klammern eingeschlossen | (00000000-0000-0000-0000-000000000000) |
X |
Vier hexadezimale Werte, die in Klammern eingeschlossen sind, wobei der vierte Wert eine Teilmenge von acht Hexadezimalwerten ist, die auch in Klammern eingeschlossen sind | {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}} |
Die -Methode löst ein aus FormatException , wenn die Zeichenfolge nicht erfolgreich analysiert werden kann. Gründe hierfür sind u. a.:
input
enthält Zeichen, die nicht Teil des Hexadezimalzeichensatzes sind.input
hat zu viele oder zu wenige Zeichen.input
befindet sich nicht in einem der von der ToString -Methode erkannten Und in der vorherigen Tabelle aufgeführten Formate.
Verwenden Sie die TryParse -Methode, um alle nicht erfolgreichen Analysevorgänge abzufangen, ohne eine Ausnahme behandeln zu müssen.
Weitere Informationen
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für