Guid 생성자

정의

네임스페이스:: System

어셈블리:: mscorlib.dll, System.Runtime.dll

어셈블리:: netstandard.dll, System.Runtime.dll

어셈블리:: System.Runtime.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

중요

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

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

오버로드

Name	Description
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[])

Source:: Guid.cs

Source:: Guid.cs

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[]

GUID를 초기화할 값을 포함하는 16개 요소 바이트 배열입니다.

예외

ArgumentNullException

b은 null입니다.

ArgumentException

b 가 16바이트 길이가 아닙니다.

적용 대상

Guid(ReadOnlySpan<Byte>)

Source:: Guid.cs

Source:: Guid.cs

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

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"는 대/소문자를 무시하는 16진수 숫자를 나타냅니다.)

연속 16진수 32자리:

dddddddddddddddddd

-또는-

그룹 간에 하이픈이 있는 8, 4, 4, 4 및 12 16진수의 그룹입니다. 필요에 따라 전체 GUID를 일치하는 중괄호 또는 괄호로 묶을 수 있습니다.

dddddddd-dddd-dddd-ddddd-ddddddddd

-또는-

{ddddddd-dddd-dddd-dddd-ddddddddd}

-또는-

(dddddddd-dddd-dddd-dddd-dddddddddd)

-또는-

8, 4, 4 16진수의 그룹 및 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(ReadOnlySpan<Byte>, Boolean)

Source:: Guid.cs

Source:: Guid.cs

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

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바이트 길이가 아닙니다.

예제

는 "000000001-0002-0003-0001-020304050607"에 해당하는 /a0>을 만듭니다.

적용 대상

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

Source:: Guid.cs

Source:: Guid.cs

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의 다음 바이트입니다.

예제

다음 예제에서는 문자열 표현이 "00000000a-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)

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Source:: Guid.cs

Important

이 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

설명

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

적용 대상

피드백

이 페이지가 도움이 되었나요?