Guid コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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.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 要素のバイト配列。
例外
b は nullです。
b は 16 バイトではありません。
適用対象
Guid(ReadOnlySpan<Byte>)
- ソース:
- Guid.cs
- ソース:
- Guid.cs
- ソース:
- 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 バイトの長さである必要があります。
例外
スパンは 16 バイトの長さである必要があります。
適用対象
Guid(String)
- ソース:
- Guid.cs
- ソース:
- Guid.cs
- ソース:
- 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 進数:
dddddddddddd
-又は-
8、4、4、4、および 12 桁の 16 進数のグループで、グループ間にハイフンが付きます。 必要に応じて、GUID 全体を一致する中かっこまたはかっこで囲むことができます。
ddddddd-dddd-dddd-dddd-ddddddd
-又は-
{dddddddd-dddd-dddd-dddd-dddddddd}
-又は-
(dddddddd-dddd-dddd-dddd-dddddddd)
-又は-
8、4、4 桁の 16 進数のグループ、および 2 桁の 16 進数の 8 つのグループのサブセット。各グループの前に "0x" または "0X" が付き、コンマで区切られています。 GUID 全体とサブセットは、一致する中かっこで囲まれています。
{0xdddddddd,0xdddd,0xdddd,{0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd}}
すべての中かっこ、コンマ、および "0x" プレフィックスが必要です。 すべての埋め込みスペースは無視されます。 グループ内の先頭のゼロはすべて無視されます。
グループに表示される 16 進数は、そのグループに表示できる意味のある 16 進数の最大数です。 1 からグループに表示される 16 進数の数まで指定できます。 指定された数字は、グループの下位桁と見なされます。
例外
g は nullです。
gの形式が無効です。
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 パラメーターの英字の 16 進数は、大文字または小文字にすることができます。 たとえば、次の文字列は同じ 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)
- ソース:
- Guid.cs
- ソース:
- Guid.cs
- ソース:
- 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
適用対象
Guid(Int32, Int16, Int16, Byte[])
- ソース:
- Guid.cs
- ソース:
- Guid.cs
- ソース:
- 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 バイト。
例外
d は nullです。
d は 8 バイト長ではありません。
例
Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) は、"00000001-0002-0003-0001-020304050607" に対応する Guid を作成します。
適用対象
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)
- ソース:
- Guid.cs
- ソース:
- Guid.cs
- ソース:
- 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}
注釈
この方法で個々のバイトを指定すると、特定の種類のコンピューターでバイトオーダー制限 (ビッグ エンディアンまたはリトル エンディアンバイトオーダー) を回避できます。
適用対象
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)
- ソース:
- Guid.cs
- ソース:
- Guid.cs
- ソース:
- 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 の次のバイト。
- 属性
注釈
この方法でバイトを指定すると、エンディアンの問題を回避できます。