Guid.Parse Guid.Parse Guid.Parse Guid.Parse Method

定義

オーバーロード

Parse(String) Parse(String) Parse(String) Parse(String)

GUID の文字列形式を、等価の Guid 構造体に変換します。Converts the string representation of a GUID to the equivalent Guid structure.

Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>)

GUID を表す読み取り専用の文字スパンを、それと等価な Guid 構造体に変換します。Converts a read-only character span that represents a GUID to the equivalent Guid structure.

Parse(String) Parse(String) Parse(String) Parse(String)

GUID の文字列形式を、等価の Guid 構造体に変換します。Converts the string representation of a GUID to the equivalent Guid structure.

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

パラメーター

input
String String String String

変換する文字列。The string to convert.

戻り値

解析された値を格納する構造体。A structure that contains the value that was parsed.

例外

input が、認識される形式ではありません。input is not in a recognized format.

次の例では、新しい GUID を作成し、"B"、"D"、"X" の各書式指定子を使用して ToString(String) メソッドを呼び出して3つの個別の文字列形式に変換した後、Parse メソッドを呼び出して、文字列を Guid の値に変換します。The following example creates a new GUID, converts it to three separate string representations by calling the ToString(String) method with the "B", "D", and "X" format specifiers, and then calls the Parse method to convert the strings back to Guid values.

using System;

public class Example
{
   public static void Main()
   {
      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) {
         try {     
            Guid newGuid = Guid.Parse(stringGuid);
            Console.WriteLine("Converted {0} to a Guid", stringGuid);
         }   
         catch (ArgumentNullException) {
            Console.WriteLine("The string to be parsed is null.");   
         }                                   
         catch (FormatException) {
            Console.WriteLine("Bad format: {0}", stringGuid);
         }
      }                                      
   }
}
// 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
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

注釈

@No__t-0 メソッドは、input の先頭または末尾の空白をトリミングし、GUID の文字列形式を Guid の値に変換します。The Parse method trims any leading or trailing white space from input and converts the string representation of a GUID to a Guid value. このメソッドでは、次の表に示すように、ToString(String) および ToString(String, IFormatProvider) の各メソッドによって生成される5つの形式のいずれかで文字列を変換できます。This method can convert strings in any of the five formats produced by the ToString(String) and ToString(String, IFormatProvider) methods, as shown in the following table.

指定子Specifier 説明Description 形式Format
N 32桁32 digits 0000000000000000000000000000000000000000000000000000000000000000
D 32ハイフンで区切られた数字32 digits separated by hyphens 00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32は、ハイフンで区切られ、中かっこで囲まれます。32 digits separated by hyphens, enclosed in braces {00000000-0000-0000-0000-000000000000}
P ハイフンで区切られた32の数字 (かっこで囲まれています)32 digits separated by hyphens, enclosed in parentheses (00000000-0000-0000-0000-000000000000)(00000000-0000-0000-0000-000000000000)
X 4つの16進値は中かっこで囲みます。4番目の値は、中かっこで囲まれた8つの16進値のサブセットです。Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces {0x00000000, 0x0000, 0x0000, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

メソッドは、文字列を正常に解析できない場合に @no__t 0 をスローします。The method throws a FormatException if it is unable to successfully parse the string. これには、次のような原因が考えられます。Here are some of the reasons why this might occur include:

  • input には、16進文字セットの一部ではない文字が含まれています。input contains characters that are not part of the hexadecimal character set.

  • input に含まれる文字数が多すぎるか、少なすぎます。input has too many or too few numeric characters.

  • input には、特定の形式に適した数字以外の文字の数が多すぎるか少なすぎます。input has too many or too few of the non-numeric characters appropriate for a particular format.

  • input は、ToString メソッドによって認識され、前の表に示した形式のいずれでもありません。input is not in one of the formats recognized by the ToString method and listed in the previous table.

@No__t-0 メソッドを使用して、失敗した解析操作をキャッチします。例外を処理する必要はありません。Use the TryParse method to catch any unsuccessful parse operations without having to handle an exception.

こちらもご覧ください

Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>)

GUID を表す読み取り専用の文字スパンを、それと等価な Guid 構造体に変換します。Converts a read-only character span that represents a GUID to the equivalent Guid structure.

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

パラメーター

input
ReadOnlySpan<Char>

GUID を表すバイトを含む読み取り専用のスパン。A read-only span containing the bytes representing a GUID.

戻り値

解析された値を格納する構造体。A structure that contains the value that was parsed.

例外

input が、認識される形式ではありません。input is not in a recognized format.

- または --or-

トリミング後、読み取り専用の文字スパンの長さは 0 になります。After trimming, the length of the read-only character span is 0.

注釈

@No__t-0 メソッドは、input の先頭または末尾の空白文字をトリムし、input の残りの文字を @no__t 3 の値に変換します。The Parse method trims any leading or trailing white space characters from input and converts the remaining characters in input to a Guid value. このメソッドは、次の表に示すように、@no__t 0 のメソッドによって生成される5つの形式のいずれかを表す文字範囲を変換できます。This method can convert a character span that represents any of the five formats produced by the ToString methods, as shown in the following table.

指定子Specifier 説明Description 形式Format
N 32桁32 digits 0000000000000000000000000000000000000000000000000000000000000000
D 32ハイフンで区切られた数字32 digits separated by hyphens 00000000-0000-0000-0000-00000000000000000000-0000-0000-0000-000000000000
B 32は、ハイフンで区切られ、中かっこで囲まれます。32 digits separated by hyphens, enclosed in braces {00000000-0000-0000-0000-000000000000}
P ハイフンで区切られた32の数字 (かっこで囲まれています)32 digits separated by hyphens, enclosed in parentheses (00000000-0000-0000-0000-000000000000)(00000000-0000-0000-0000-000000000000)
X 4つの16進値は中かっこで囲みます。4番目の値は、中かっこで囲まれた8つの16進値のサブセットです。Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces {0x00000000, 0x0000, 0x0000, {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00}}{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

メソッドは、文字列を正常に解析できない場合に @no__t 0 をスローします。The method throws a FormatException if it is unable to successfully parse the string. これには、次のような原因が考えられます。Here are some of the reasons why this might occur include:

  • input には、16進文字セットの一部ではない文字が含まれています。input contains characters that are not part of the hexadecimal character set.

  • input に含まれる文字数が多すぎるか、少なすぎます。input has too many or too few numeric characters.

  • input には、特定の形式に適した数字以外の文字の数が多すぎるか少なすぎます。input has too many or too few of the non-numeric characters appropriate for a particular format.

  • input は、ToString メソッドによって認識され、前の表に示した形式のいずれでもありません。input is not in one of the formats recognized by the ToString method and listed in the previous table.

@No__t-0 メソッドを使用して、失敗した解析操作をキャッチします。例外を処理する必要はありません。Use the TryParse method to catch any unsuccessful parse operations without having to handle an exception.

適用対象