Teilen über


Guid.Parse Methode

Definition

Überlädt

Parse(String, IFormatProvider)

Analysiert eine Zeichenfolge in einen Wert.

Parse(ReadOnlySpan<Char>, IFormatProvider)

Analysiert eine Spanne von Zeichen in einen Wert.

Parse(String)

Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid Struktur.

Parse(ReadOnlySpan<Char>)

Konvertiert einen schreibgeschützten Zeichenbereich, der eine GUID darstellt, 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 sbereitstellt.

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 sbereitstellt.

Gibt zurück

Das Ergebnis der Analyse s.

Implementiert

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.

input ist nicht in einem erkannten Format vorhanden.

Beispiele

Im folgenden Beispiel wird eine neue GUID erstellt, in drei separate Zeichenfolgendarstellungen konvertiert, indem die ToString(String)-Methode mit den Formatbezeichnern "B", "D" und "X" aufgerufen wird. Anschließend wird die Parse Methode aufgerufen, um die Zeichenfolgen wieder in Guid Werte zu 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

Mit der Parse-Methode werden führende oder nachfolgende Leerzeichen von input gekürzt und die Zeichenfolgendarstellung einer GUID in einen Guid Wert konvertiert. Diese Methode kann Zeichenfolgen in einem der fünf Formate konvertieren, die von den methoden ToString(String) und ToString(String, IFormatProvider) erstellt werden, wie in der folgenden Tabelle dargestellt.

Spezifikationssymbol Beschreibung Format
N 32 Hexadezimalziffern 00000000000000000000000000000000
D 32 hexadezimale Ziffern getrennt durch Bindestriche 00000000-0000-0000-0000-000000000000
B 32 hexadezimale Ziffern, getrennt durch Bindestriche, eingeschlossen in geschweifte Klammern {00000000-0000-0000-0000-000000000000}
P 32 hexadezimale Ziffern, getrennt durch Bindestriche, eingeschlossen in Klammern (00000000-0000-0000-0000-000000000000)
X Vier hexadezimale Werte, die in geschweifte Klammern eingeschlossen sind, wobei der vierte Wert eine Teilmenge von acht Hexadezimalwerten ist, die auch in geschweifte Klammern eingeschlossen sind {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Die Methode löst eine FormatException aus, wenn die Zeichenfolge nicht erfolgreich analysiert werden kann. Einige der Gründe, warum dies auftreten kann, sind:

  • 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 Formate, die von der ToString-Methode erkannt und in der vorherigen Tabelle aufgeführt sind.

Verwenden Sie die TryParse-Methode, um erfolglose Analysevorgänge abzufangen, ohne eine Ausnahme behandeln zu müssen.

Weitere Informationen

Gilt für:

Parse(ReadOnlySpan<Char>)

Quelle:
Guid.cs
Quelle:
Guid.cs
Quelle:
Guid.cs

Konvertiert einen schreibgeschützten Zeichenbereich, der 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

input ist nicht in einem erkannten Format vorhanden.

-oder-

Nach dem Kürzen beträgt die Länge des schreibgeschützten Zeichenbereichs 0.

Hinweise

Mit der Parse-Methode werden führende oder nachfolgende Leerzeichen von input gekürzt und die verbleibenden Zeichen in input in einen Guid Wert konvertiert. Diese Methode kann einen Zeichenbereich konvertieren, der eines der fünf Formate darstellt, die von den ToString Methoden erstellt werden, wie in der folgenden Tabelle dargestellt.

Spezifikationssymbol Beschreibung Format
N 32 Hexadezimalziffern 00000000000000000000000000000000
D 32 hexadezimale Ziffern getrennt durch Bindestriche 00000000-0000-0000-0000-000000000000
B 32 hexadezimale Ziffern, getrennt durch Bindestriche, eingeschlossen in geschweifte Klammern {00000000-0000-0000-0000-000000000000}
P 32 hexadezimale Ziffern, getrennt durch Bindestriche, eingeschlossen in Klammern (00000000-0000-0000-0000-000000000000)
X Vier hexadezimale Werte, die in geschweifte Klammern eingeschlossen sind, wobei der vierte Wert eine Teilmenge von acht Hexadezimalwerten ist, die auch in geschweifte Klammern eingeschlossen sind {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

Die Methode löst eine FormatException aus, wenn die Zeichenfolge nicht erfolgreich analysiert werden kann. Einige der Gründe, warum dies auftreten kann, sind:

  • 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 Formate, die von der ToString-Methode erkannt und in der vorherigen Tabelle aufgeführt sind.

Verwenden Sie die TryParse-Methode, um erfolglose Analysevorgänge abzufangen, ohne eine Ausnahme behandeln zu müssen.

Gilt für: