Guid 建構函式

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 Guid 結構的新執行個體。

多載

Guid(Byte[])	使用指定的位元組陣列，初始化 Guid 結構的新執行個體。
Guid(ReadOnlySpan<Byte>)	使用指定唯讀位元組範圍代表的值，初始化 Guid 結構的新執行個體。
Guid(String)	使用指定字串表示的值，初始化 Guid 結構的新執行個體。
Guid(ReadOnlySpan<Byte>, Boolean)
Guid(Int32, Int16, Int16, Byte[])	使用指定的整數和位元組陣列，初始化 Guid 結構的新執行個體。
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	使用指定的整數和位元組，初始化 Guid 結構的新執行個體。
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	使用指定不帶正負號的整數 (Unsigned Integer) 和位元組，初始化 Guid 結構的新執行個體。

Guid(Byte[])

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

使用指定的位元組陣列，初始化 Guid 結構的新執行個體。

public:
 Guid(cli::array <System::Byte> ^ b);

public Guid (byte[] b);

new Guid : byte[] -> Guid

Public Sub New (b As Byte())

參數

b: Byte[]

16 個元素位元組陣列，包含要用來初始化 GUID 的值。

例外狀況

ArgumentNullException

b 為 null。

ArgumentException

b 的長度不是 16 個位元組。

適用於

Guid(ReadOnlySpan<Byte>)

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

使用指定唯讀位元組範圍代表的值，初始化 Guid 結構的新執行個體。

public:
 Guid(ReadOnlySpan<System::Byte> b);

public Guid (ReadOnlySpan<byte> b);

new Guid : ReadOnlySpan<byte> -> Guid

Public Sub New (b As ReadOnlySpan(Of Byte))

參數

b: ReadOnlySpan<Byte>

包含代表 GUID 之位元組的唯讀範圍。範圍長度必須剛好是 16 個位元組。

例外狀況

ArgumentException

範圍長度必須剛好是 16 個位元組。

適用於

Guid(String)

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

使用指定字串表示的值，初始化 Guid 結構的新執行個體。

public:
 Guid(System::String ^ g);

public Guid (string g);

new Guid : string -> Guid

Public Sub New (g As String)

參數

g: String

字串，包含下列格式之一的 GUID ("d" 代表十六進位數字，忽略大小寫)：

32 個連續十六進位數位：

dddddddddddddddddddddddddddddddd

-或-

群組之間具有連字號的 8、4、4、4 和 12 個十六進位數位。整個 GUID 可以選擇性地用對稱的大括號或括號括起來：

dddddddd-dddd-dddd-dddd-dddddddddddd

-或-

{dddddddd-dddd-dddd-dddd-dddddddddddd}

-或-

(dddddddd-dddd-dddd-dddd-dddddddddddd)

-或-

8、4 和 4 個十六進位數位的群組，以及 2 個十六進位數位群組的子集，每個群組前面加上「0x」或「0X」，並以逗號分隔。整個 GUID 和子集都用對稱的大括號括起來︰

{0xdddddddd, 0xdddd, 0xdddd,{0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd}}

所有的大括號、逗號和 "0x" 都是必要的。所有內嵌的空白都會被忽略。群組中所有前置的零都會被忽略。

群組中顯示的十六進位數位是可以出現在該群組中有意義的十六進位數位數目上限。您可以指定從 1 到群組所顯示的十六進位數位數目。所指定的數字會假設為群組的低序位數字。

例外狀況

ArgumentNullException

g 為 null。

FormatException

g 的格式無效。

OverflowException

g 的格式無效。

範例

下列範例會將一節中列出的每個字串傳遞至建 Guid(String) 構函式。

string[] guidStrings = { "ca761232ed4211cebacd00aa0057b223",
                         "CA761232-ED42-11CE-BACD-00AA0057B223",
                         "{CA761232-ED42-11CE-BACD-00AA0057B223}",
                         "(CA761232-ED42-11CE-BACD-00AA0057B223)",
                         "{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}" };
foreach (var guidString in guidStrings)
{
    var guid = new Guid(guidString);
    Console.WriteLine($"Original string: {guidString}");
    Console.WriteLine($"Guid:            {guid}");
    Console.WriteLine();
}

// The example displays the following output:
//    Original string: ca761232ed4211cebacd00aa0057b223
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: CA761232-ED42-11CE-BACD-00AA0057B223
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: {CA761232-ED42-11CE-BACD-00AA0057B223}
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: (CA761232-ED42-11CE-BACD-00AA0057B223)
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: {0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223

open System

let guidStrings =
    [ "ca761232ed4211cebacd00aa0057b223"
      "CA761232-ED42-11CE-BACD-00AA0057B223"
      "{CA761232-ED42-11CE-BACD-00AA0057B223}"
      "(CA761232-ED42-11CE-BACD-00AA0057B223)"
      "{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}" ]

for guidString in guidStrings do
    let guid = Guid guidString
    printfn $"Original string: {guidString}"
    printfn $"Guid:            {guid}\n"

// The example displays the following output:
//    Original string: ca761232ed4211cebacd00aa0057b223
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: CA761232-ED42-11CE-BACD-00AA0057B223
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: {CA761232-ED42-11CE-BACD-00AA0057B223}
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: (CA761232-ED42-11CE-BACD-00AA0057B223)
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: {0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223

Module Example
   Public Sub Main()
      Dim guidStrings() As String = { "ca761232ed4211cebacd00aa0057b223",
                                      "CA761232-ED42-11CE-BACD-00AA0057B223", 
                                      "{CA761232-ED42-11CE-BACD-00AA0057B223}", 
                                      "(CA761232-ED42-11CE-BACD-00AA0057B223)", 
                                      "{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}" }
      For Each guidString In guidStrings
         Dim guid As New Guid(guidString)
         Console.WriteLine("Original string: {0}", guidString)
         Console.WriteLine("Guid:            {0}", guid)
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'    Original string: ca761232ed4211cebacd00aa0057b223
'    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
'    
'    Original string: CA761232-ED42-11CE-BACD-00AA0057B223
'    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
'    
'    Original string: {CA761232-ED42-11CE-BACD-00AA0057B223}
'    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
'    
'    Original string: (CA761232-ED42-11CE-BACD-00AA0057B223)
'    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
'    
'    Original string: {0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}
'    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223

備註

參數中的 g 字母十六進位數位可以是大寫或小寫。例如，下列字串代表相同的 GUID：

「ca761232ed4211cebacd00aa0057b223」

「CA761232-ED42-11CE-BACD-00AA0057B223」

「{CA761232-ED42-11CE-BACD-00AA0057B223}」

「 (CA761232-ED42-11CE-BACD-00AA0057B223) 」

「{0xCA761232， 0xED42， 0x11CE， {0xBA， 0xCD， 0x00， 0xAA， 0x00， 0x57， 0xB2， 0x23}}」

適用於

Guid(ReadOnlySpan<Byte>, Boolean)

Source:: Guid.cs

Source:: Guid.cs

public:
 Guid(ReadOnlySpan<System::Byte> b, bool bigEndian);

public Guid (ReadOnlySpan<byte> b, bool bigEndian);

new Guid : ReadOnlySpan<byte> * bool -> Guid

Public Sub New (b As ReadOnlySpan(Of Byte), bigEndian As Boolean)

參數

b: ReadOnlySpan<Byte>

bigEndian: Boolean

適用於

Guid(Int32, Int16, Int16, Byte[])

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

使用指定的整數和位元組陣列，初始化 Guid 結構的新執行個體。

public:
 Guid(int a, short b, short c, cli::array <System::Byte> ^ d);

public Guid (int a, short b, short c, byte[] d);

new Guid : int * int16 * int16 * byte[] -> Guid

Public Sub New (a As Integer, b As Short, c As Short, d As Byte())

參數

a: Int32

GUID 的前 4 個位元組。

b: Int16

GUID 接下來的 2 個位元組。

c: Int16

GUID 接下來的 2 個位元組。

d: Byte[]

GUID 剩餘的 8 個位元組。

例外狀況

ArgumentNullException

d 為 null。

ArgumentException

d 的長度不是 8 個位元組。

範例

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7})Guid會建立對應至「00000001-0002-0003-0001-020304050607」的。

適用於

Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

使用指定的整數和位元組，初始化 Guid 結構的新執行個體。

public:
 Guid(int a, short b, short c, System::Byte d, System::Byte e, System::Byte f, System::Byte g, System::Byte h, System::Byte i, System::Byte j, System::Byte k);

public Guid (int a, short b, short c, byte d, byte e, byte f, byte g, byte h, byte i, byte j, byte k);

new Guid : int * int16 * int16 * byte * byte * byte * byte * byte * byte * byte * byte -> Guid

Public Sub New (a As Integer, b As Short, c As Short, d As Byte, e As Byte, f As Byte, g As Byte, h As Byte, i As Byte, j As Byte, k As Byte)

參數

a: Int32

GUID 的前 4 個位元組。

b: Int16

GUID 接下來的 2 個位元組。

c: Int16

GUID 接下來的 2 個位元組。

d: Byte

GUID 的下一個位元組。

e: Byte

GUID 的下一個位元組。

f: Byte

GUID 的下一個位元組。

g: Byte

GUID 的下一個位元組。

h: Byte

GUID 的下一個位元組。

i: Byte

GUID 的下一個位元組。

j: Byte

GUID 的下一個位元組。

k: Byte

GUID 的下一個位元組。

範例

下列範例會建立 GUID，其字串標記法為「0000000a-000b-000c-0001-020304050607」。

var g = new Guid(0xA, 0xB, 0xC,
                  new Byte[] { 0, 1, 2, 3, 4, 5, 6, 7 } );
Console.WriteLine($"{g:B}");

// The example displays the following output:
//        {0000000a-000b-000c-0001-020304050607}

open System

let g = Guid(0xA, 0xBs, 0xCs, [| 0uy..7uy |])
printfn $"{g:B}"

// The example displays the following output:
//        {0000000a-000b-000c-0001-020304050607}

Module Example
   Public Sub Main()
      Dim g As New Guid(&hA, &hB, &hC, 
                        New Byte() { 0, 1, 2, 3, 4, 5, 6, 7 } )
      Console.WriteLine("{0:B}", g)
   End Sub
End Module
' The example displays the following output:
'   {0000000a-000b-000c-0001-020304050607}

備註

以這種方式指定個別位元組可用來規避特定電腦類型的位元組順序限制， (big-endian 或 small-endian 位元組順序) 。

適用於

Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

重要

此 API 不符合 CLS 規範。

使用指定不帶正負號的整數 (Unsigned Integer) 和位元組，初始化 Guid 結構的新執行個體。

public:
 Guid(System::UInt32 a, System::UInt16 b, System::UInt16 c, System::Byte d, System::Byte e, System::Byte f, System::Byte g, System::Byte h, System::Byte i, System::Byte j, System::Byte k);

[System.CLSCompliant(false)]
public Guid (uint a, ushort b, ushort c, byte d, byte e, byte f, byte g, byte h, byte i, byte j, byte k);

[<System.CLSCompliant(false)>]
new Guid : uint32 * uint16 * uint16 * byte * byte * byte * byte * byte * byte * byte * byte -> Guid

Public Sub New (a As UInteger, b As UShort, c As UShort, d As Byte, e As Byte, f As Byte, g As Byte, h As Byte, i As Byte, j As Byte, k As Byte)

參數

a: UInt32

GUID 的前 4 個位元組。

b: UInt16

GUID 接下來的 2 個位元組。

c: UInt16

GUID 接下來的 2 個位元組。

d: Byte

GUID 的下一個位元組。

e: Byte

GUID 的下一個位元組。

f: Byte

GUID 的下一個位元組。

g: Byte

GUID 的下一個位元組。

h: Byte

GUID 的下一個位元組。

i: Byte

GUID 的下一個位元組。

j: Byte

GUID 的下一個位元組。

k: Byte

GUID 的下一個位元組。

屬性: CLSCompliantAttribute

備註

以這種方式指定位元組可避免尾端問題。

適用於

Guid 建構函式

定義

多載

Guid(Byte[])

參數

例外狀況

適用於

Guid(ReadOnlySpan<Byte>)

參數

例外狀況

適用於

Guid(String)

參數

例外狀況

範例

備註

適用於

Guid(ReadOnlySpan<Byte>, Boolean)

參數

適用於

Guid(Int32, Int16, Int16, Byte[])

參數

例外狀況

範例

適用於

Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

參數

範例

備註

適用於

Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

參數

備註

適用於

意見反應

其他資源