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)	指定した符号なし整数とバイトを使用して、Guid 構造体の新しいインスタンスを初期化します。

Guid(Byte[])

ソース:: Guid.cs

ソース:: Guid.cs

ソース:: 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[]

GUID を初期化するための値を含む 16 要素のバイト配列。

例外

ArgumentNullException

b が nullです。

ArgumentException

b の長さが 16 バイトではありません。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Guid(ReadOnlySpan<Byte>)

ソース:: Guid.cs

ソース:: Guid.cs

ソース:: 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 バイトである必要があります。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

Guid(String)

ソース:: Guid.cs

ソース:: Guid.cs

ソース:: 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" は、大文字と小文字が区別されない 16 進数の文字を表します)。

連続する 32 桁の 16 進数:

dddddddddddddddddddddddddddddddd

または

8、4、4、4、および 12 桁の 16 進数のグループで、グループ間にハイフンが付きます。左右が対応している中かっこや丸かっこで GUID 全体を囲むこともできます。

dddddddd-dddd-dddd-dddd-dddddddddddd

または

{dddddddd-dddd-dddd-dddd-dddddddddddd}

または

(dddddddd-dddd-dddd-dddd-dddddddddddd)

または

8 桁、4 桁、4 桁の 16 進数のグループ、および 2 桁の 16 進数の 8 つのグループのサブセット。各グループの先頭には "0x" または "0X" が付き、コンマで区切られます。 GUID 全体およびサブセットは、左右が対応している中かっこで囲みます。

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

中かっこ、コンマ、プリフィックスの "0x" はすべて必須です。埋め込まれている空白はすべて無視されます。グループの先頭にある 0 はすべて無視されます。

グループに表示される 16 進数は、そのグループに表示できる意味のある 16 進数の最大数です。 1 からグループに表示される 16 進数の数を指定できます。指定した数字は、そのグループの下位の桁と見なされます。

例外

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

注釈

パラメーターのアルファベットの 16 進数は 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}} "

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Guid(ReadOnlySpan<Byte>, Boolean)

ソース:: Guid.cs

ソース:: 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

適用対象

.NET 9 および .NET 8

製品	バージョン
.NET	8, 9

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

ソース:: Guid.cs

ソース:: Guid.cs

ソース:: 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" に対応するを作成します。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

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

ソース:: Guid.cs

ソース:: Guid.cs

ソース:: 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 の次のバイト。

例

次の例では、文字列表現が "0000000a-000b-000c-0001-020304050607" である GUID を作成します。

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}

注釈

この方法で個々のバイトを指定すると、特定の種類のコンピューターでバイト順の制限 (ビッグエンディアンまたはリトルエンディアンのバイト順) を回避するために使用できます。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

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

ソース:: Guid.cs

ソース:: Guid.cs

ソース:: Guid.cs

重要

この API は CLS 準拠ではありません。

指定した符号なし整数とバイトを使用して、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

注釈

この方法でバイトを指定すると、エンディアンの問題を回避できます。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

次の方法で共有

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)

パラメーター

注釈

適用対象

その他のリソース