Guid 생성자

정의

Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure.

오버로드

Guid(Byte[])

지정된 바이트 배열을 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the specified array of bytes.

Guid(ReadOnlySpan<Byte>)

지정된 읽기 전용 바이트 범위가 나타내는 값을 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the value represented by the specified read-only span of bytes.

Guid(String)

지정된 문자열이 나타내는 값을 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the value represented by the specified string.

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

지정된 정수 및 바이트 배열을 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the specified integers and byte array.

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

지정된 정수 및 바이트를 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the specified integers and bytes.

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

지정된 부호 없는 정수 및 바이트를 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the specified unsigned integers and bytes.

Guid(Byte[])

지정된 바이트 배열을 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the specified array of bytes.

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 요소 바이트 배열입니다.A 16-element byte array containing values with which to initialize the GUID.

예외

b이(가) null인 경우b is null.

b의 길이가 16바이트가 아닌 경우b is not 16 bytes long.

Guid(ReadOnlySpan<Byte>)

지정된 읽기 전용 바이트 범위가 나타내는 값을 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the value represented by the specified read-only span of bytes.

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를 나타내는 바이트를 포함하는 읽기 전용 범위입니다.A read-only span containing the bytes representing the GUID. 범위는 정확히 16바이트여야 합니다.The span must be exactly 16 bytes long.

예외

범위는 정확히 16바이트여야 합니다.The span must be exactly 16 bytes long.

Guid(String)

지정된 문자열이 나타내는 값을 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the value represented by the specified string.

public:
 Guid(System::String ^ g);
public Guid (string g);
new Guid : string -> Guid
Public Sub New (g As String)

매개 변수

g
String

다음 형식 중 하나인 GUID를 포함하는 문자열입니다. 여기에서 "d"는 대/소문자가 무시된 16진수를 나타냅니다.A string that contains a GUID in one of the following formats ("d" represents a hexadecimal digit whose case is ignored):

32자리 숫자:32 contiguous digits:

dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd

또는-or-

그룹 사이가 하이픈으로 구분된 8자리, 4자리, 4자리, 4자리 및 12자리 숫자 그룹Groups of 8, 4, 4, 4, and 12 digits with hyphens between the groups. 전체 GUID는 선택적으로 중괄호나 괄호 한 쌍으로 묶을 수 있습니다.The entire GUID can optionally be enclosed in matching braces or parentheses:

dddddddd-dddd-dddd-dddd-dddddddddddddddddddd-dddd-dddd-dddd-dddddddddddd

또는-or-

{dddddddd-dddd-dddd-dddd-dddddddddddd}{dddddddd-dddd-dddd-dddd-dddddddddddd}

또는-or-

(dddddddd-dddd-dddd-dddd-dddddddddddd)(dddddddd-dddd-dddd-dddd-dddddddddddd)

또는-or-

각 그룹 앞에 "0x"나 "0X"가 붙고 쉼표로 분리된 8자리, 4자리, 4자리 그룹과 각 그룹의 2자리 하위 집합Groups of 8, 4, and 4 digits, and a subset of eight groups of 2 digits, with each group prefixed by "0x" or "0X", and separated by commas. 하위 집합뿐 아니라 전체 GUID가 중괄호로 묶입니다.The entire GUID, as well as the subset, is enclosed in matching braces:

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

모든 중괄호, 쉼표 및 "0x" 접두사는 필수입니다.All braces, commas, and "0x" prefixes are required. 포함된 모든 공백은 무시됩니다.All embedded spaces are ignored. 그룹에서 처음에 나오는 0은 모두 무시됩니다.All leading zeros in a group are ignored.

그룹에서 표시되는 자릿수는 그룹에서 나타날 수 있는 의미 있는 최대 자릿수입니다.The digits shown in a group are the maximum number of meaningful digits that can appear in that group. 1부터 그룹에서 표시되는 자릿수까지 지정할 수 있습니다.You can specify from 1 to the number of digits shown for a group. 지정된 자릿수는 그룹의 하위 자릿수로 간주됩니다.The specified digits are assumed to be the low-order digits of the group.

예외

g이(가) null인 경우g is null.

g의 형식이 잘못되었습니다.The format of g is invalid.

g의 형식이 잘못되었습니다.The format of g is invalid.

예제

다음 예제에서는 설명 섹션에 나열 된 각 문자열을 Guid(String) 생성자에 전달 합니다.The following example passes each string listed in the Remarks section to the Guid(String) constructor.

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
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 진수는 대 문자와 소문자를 사용할 수 있습니다.The alphabetic hexadecimal digits in the g parameter can be uppercase or lowercase. 예를 들어 다음 문자열에 동일한 GUID를 나타냅니다.For example, the following strings represent the same GUID:

"ca761232ed4211cebacd00aa0057b223""ca761232ed4211cebacd00aa0057b223"

"CA761232-ED42-11CE-BACD-00AA0057B223""CA761232-ED42-11CE-BACD-00AA0057B223"

"{CA761232-ED42-11CE-BACD-00AA0057B223}""{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}}""{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}"

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

지정된 정수 및 바이트 배열을 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the specified integers and byte array.

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바이트입니다.The first 4 bytes of the GUID.

b
Int16

GUID의 다음 2바이트입니다.The next 2 bytes of the GUID.

c
Int16

GUID의 다음 2바이트입니다.The next 2 bytes of the GUID.

d
Byte[]

GUID의 나머지 8바이트입니다.The remaining 8 bytes of the GUID.

예외

d이(가) null인 경우d is null.

d의 길이가 8바이트가 아닌 경우d is not 8 bytes long.

예제

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) "00000001-0002-0003-0001-020304050607"에 해당 하는 Guid를 만듭니다.Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) creates a Guid that corresponds to "00000001-0002-0003-0001-020304050607".

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

지정된 정수 및 바이트를 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the specified integers and bytes.

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바이트입니다.The first 4 bytes of the GUID.

b
Int16

GUID의 다음 2바이트입니다.The next 2 bytes of the GUID.

c
Int16

GUID의 다음 2바이트입니다.The next 2 bytes of the GUID.

d
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

e
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

f
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

g
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

h
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

i
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

j
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

k
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

예제

다음 예제에서는 해당 문자열 표현은 "0000000a-000b-000c-0001-020304050607 에" GUID를 만듭니다.The following example creates a GUID whose string representation is "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}
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 또는 little endian 바이트 순서)를 우회 하 사용할 수 있습니다.Specifying individual bytes in this manner can be used to circumvent byte order restrictions (big-endian or little-endian byte order) on particular types of computers.

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

중요

이 API는 CLS 규격이 아닙니다.

지정된 부호 없는 정수 및 바이트를 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.Initializes a new instance of the Guid structure by using the specified unsigned integers and bytes.

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);
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바이트입니다.The first 4 bytes of the GUID.

b
UInt16

GUID의 다음 2바이트입니다.The next 2 bytes of the GUID.

k
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

c
UInt16

GUID의 다음 2바이트입니다.The next 2 bytes of the GUID.

d
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

e
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

f
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

g
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

h
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

i
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

j
Byte

GUID의 다음 바이트입니다.The next byte of the GUID.

특성

예제

Guid (0xa, 0xb, 0xb, 0, 1, 2, 3, 4, 5, 6, 7)는 "0000000a-000c-0001-020304050607"에 해당 하는 Guid을 만듭니다.Guid(0xa,0xb,0xc,0,1,2,3,4,5,6,7) creates a Guid that corresponds to "0000000a-000b-000c-0001-020304050607".

설명

이 방식으로 바이트를 지정 엔디언 문제를 방지할 수 있습니다.Specifying the bytes in this manner avoids endianness issues.

적용 대상