Guid 생성자

참조

정의

네임스페이스:: System

어셈블리:: System.Runtime.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

Guid 구조체의 새 인스턴스를 초기화합니다.

오버로드

Guid(Byte[])	지정된 바이트 배열을 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.
Guid(ReadOnlySpan<Byte>)	지정된 읽기 전용 바이트 범위가 나타내는 값을 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.
Guid(String)	지정된 문자열이 나타내는 값을 사용하여 Guid 구조체의 새 인스턴스를 초기화합니다.
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 구조체의 새 인스턴스를 초기화합니다.

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바이트가 아닌 경우

적용 대상

Guid(ReadOnlySpan<Byte>)

지정된 읽기 전용 바이트 범위가 나타내는 값을 사용하여 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)

지정된 문자열이 나타내는 값을 사용하여 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진수를 나타냅니다.

연속 16진수 32자리:

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, 46진수의 그룹 및 26진수로 구성된 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}}"

적용 대상

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

지정된 정수 및 바이트 배열을 사용하여 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 는 "000000001-0002-0003-0001-020304050607"에 해당하는 것을 만듭니다.

적용 대상

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

지정된 정수 및 바이트를 사용하여 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}

설명

이러한 방식으로 개별 바이트를 지정하면 특정 유형의 컴퓨터에서 바이트 순서 제한(big-endian 또는 little-endian 바이트 순서)을 우회하는 데 사용할 수 있습니다.

적용 대상

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

중요

이 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

설명

이러한 방식으로 바이트를 지정하면 엔디안성 문제가 발생하지 않습니다.

적용 대상

Guid 생성자

정의

오버로드

Guid(Byte[])

매개 변수

예외

적용 대상

Guid(ReadOnlySpan<Byte>)

매개 변수

예외

적용 대상

Guid(String)

매개 변수

예외

예제

설명

적용 대상

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)

매개 변수

설명

적용 대상

추가 리소스