Guid Guid Guid Guid Struct

정의

GUID(Globally Unique IDentifier)를 나타냅니다. Represents a globally unique identifier (GUID).

public value class Guid : IComparable, IComparable<Guid>, IEquatable<Guid>, IFormattable
[System.Runtime.InteropServices.ComVisible(true)]
[Serializable]
public struct Guid : IComparable, IComparable<Guid>, IEquatable<Guid>, IFormattable
type Guid = struct
    interface IFormattable
Public Structure Guid
Implements IComparable, IComparable(Of Guid), IEquatable(Of Guid), IFormattable
상속
특성
ComVisibleAttribute SerializableAttribute
구현

예제

다음 예제에서는 System.Runtime.InteropServices.GuidAttribute 인터페이스 및 사용자 정의 클래스 GUID를 할당 하는 클래스입니다.The following example uses the System.Runtime.InteropServices.GuidAttribute class to assign a GUID to an interface and to a user-defined class. 호출 하 여 GUID의 값을 검색 하는 것을 GetCustomAttribute 메서드 같은지 여부를 확인 하려면 다른 두 Guid와 비교 합니다.It retrieves the value of the GUID by calling the GetCustomAttribute method, and compares it with two other GUIDs to determine whether they are equal.

using namespace System;
using namespace System::Runtime::InteropServices;

// Guid for the interface IMyInterface.
[Guid("F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4")]
public interface class IMyInterface
{
public:
   void MyMethod();
};


// Guid for the coclass MyTestClass.
[Guid("936DA01F-9ABD-4d9d-80C7-02AF85C822A8")]
public ref class MyTestClass: public IMyInterface
{
public:
   virtual void MyMethod(){}
};

int main()
{
   Attribute^ IMyInterfaceAttribute = Attribute::GetCustomAttribute( IMyInterface::typeid, GuidAttribute::typeid );

   // The Value property of GuidAttribute returns a string. 
   System::Console::WriteLine( String::Concat(  "IMyInterface Attribute: ", (dynamic_cast<GuidAttribute^>(IMyInterfaceAttribute))->Value ) );

   // Using the string to create a guid.
   Guid myGuid1 = Guid(dynamic_cast<GuidAttribute^>(IMyInterfaceAttribute)->Value);

   // Using a byte array to create a guid.
   Guid myGuid2 = Guid(myGuid1.ToByteArray());

   // Equals is overridden to perform a value comparison.
   if ( myGuid1.Equals( myGuid2 ) )
      System::Console::WriteLine(  "myGuid1 equals myGuid2" );
   else
      System::Console::WriteLine(  "myGuid1 not equals myGuid2" );

   // Equality operator can also be used to determine if two guids have same value.
   if ( myGuid1 == myGuid2 )
      System::Console::WriteLine(  "myGuid1 == myGuid2" );
   else
      System::Console::WriteLine(  "myGuid1 != myGuid2" );
}
// The example displays the following output:
//       IMyInterface Attribute: F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4
//       myGuid1 equals myGuid2
//       myGuid1 == myGuid2
using System;
using System.Runtime.InteropServices;

// Guid for the interface IMyInterface.
[Guid("F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4")]
interface IMyInterface
{
    void MyMethod();
}

// Guid for the coclass MyTestClass.
[Guid("936DA01F-9ABD-4d9d-80C7-02AF85C822A8")]
public class MyTestClass : IMyInterface
{
    public void MyMethod() {}

    public static void Main( string []args )
    {
        GuidAttribute IMyInterfaceAttribute = (GuidAttribute) Attribute.GetCustomAttribute(typeof(IMyInterface), typeof(GuidAttribute));
        
        System.Console.WriteLine("IMyInterface Attribute: " + IMyInterfaceAttribute.Value );    

        // Use the string to create a guid.
        Guid myGuid1 = new Guid(IMyInterfaceAttribute.Value );
        // Use a byte array to create a guid.
        Guid myGuid2 = new Guid(myGuid1.ToByteArray());

        if (myGuid1.Equals(myGuid2))
            System.Console.WriteLine("myGuid1 equals myGuid2");
        else
            System.Console.WriteLine("myGuid1 does not equal myGuid2" );

        // Equality operator can also be used to determine if two guids have same value.
        if ( myGuid1 == myGuid2 )
            System.Console.WriteLine( "myGuid1 == myGuid2" );
        else
            System.Console.WriteLine( "myGuid1 != myGuid2" );
    }
}
// The example displays the following output:
//       IMyInterface Attribute: F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4
//       myGuid1 equals myGuid2
//       myGuid1 == myGuid2
Imports System.Runtime.InteropServices

' Guid for the interface IMyInterface.
<Guid("F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4")> _
Interface IMyInterface
    Sub MyMethod()
End Interface

' Guid for the coclass MyTestClass.
<Guid("936DA01F-9ABD-4d9d-80C7-02AF85C822A8")> _
Public Class MyTestClass
    Implements IMyInterface

    Public Sub MyMethod() Implements IMyInterface.MyMethod
    End Sub

    Public Shared Sub Main()
        Dim IMyInterfaceAttribute As GuidAttribute = CType(Attribute.GetCustomAttribute(GetType(IMyInterface), GetType(GuidAttribute)),
                                                           GuidAttribute)

        Console.WriteLine("IMyInterface Attribute: " + IMyInterfaceAttribute.Value)

        ' Use the string to create a guid.
        Dim myGuid1 As New Guid(IMyInterfaceAttribute.Value)
        ' Use a byte array to create a guid.
        Dim myGuid2 As New Guid(myGuid1.ToByteArray())

        If myGuid1.Equals(myGuid2) Then
            Console.WriteLine("myGuid1 equals myGuid2")
        Else
            Console.WriteLine("myGuid1 does not equal myGuid2")
        End If 

        ' The equality operator can also be used to determine if two guids have same value.
        If myGuid1.ToString() = myGuid2.ToString() Then
            Console.WriteLine("myGuid1 == myGuid2")
        Else
            Console.WriteLine("myGuid1 != myGuid2")
        End If
    End Sub
End Class
' The example displays the following output:
'       IMyInterface Attribute: F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4
'       myGuid1 equals myGuid2
'       myGuid1 == myGuid2

GuidAttribute com 형식을 노출 하는 응용 프로그램 특성은 일반적으로 사용Note that the GuidAttribute attribute is typically used in an application to expose a type to COM. 이 예제를 컴파일할 경우 실행할 수 있습니다 합니다 어셈블리 등록 도구 (Regasm.exe) 레지스트리 (.reg)을 만들고 형식 라이브러리 (.tlb) 파일에 생성된 된 어셈블리에 있습니다.If you compile this example, you can run the Assembly Registration tool (Regasm.exe) on the generated assembly to create registry (.reg) and type library (.tlb) files. Coclass를 레지스트리에 등록.reg 파일을 사용할 수 및.tlb 파일 COM interop에 대 한 메타 데이터를 제공할 수 있습니다.The .reg file can be used to register the coclass in the registry, and the .tlb file can provide metadata for COM interop.

설명

GUID에는 고유 식별자가 필요한 모든 곳에서 모든 컴퓨터 및 네트워크에서 사용할 수 있는 128 비트 정수 (16 바이트)입니다.A GUID is a 128-bit integer (16 bytes) that can be used across all computers and networks wherever a unique identifier is required. 이러한 식별자가 중복 될 확률은 매우 낮습니다.Such an identifier has a very low probability of being duplicated.

생성자

Guid(Byte[]) Guid(Byte[]) Guid(Byte[]) Guid(Byte[])

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

Guid(ReadOnlySpan<Byte>) Guid(ReadOnlySpan<Byte>) Guid(ReadOnlySpan<Byte>) Guid(ReadOnlySpan<Byte>)
Guid(String) Guid(String) Guid(String) 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(Int32, Int16, Int16, Byte[]) Guid(Int32, Int16, Int16, Byte[]) 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(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte) Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte) 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, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte) Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte) Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte) Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

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

필드

Empty Empty Empty Empty

모든 값이 0인 Guid 구조체의 읽기 전용 인스턴스입니다. A read-only instance of the Guid structure whose value is all zeros.

메서드

CompareTo(Guid) CompareTo(Guid) CompareTo(Guid) CompareTo(Guid)

이 인스턴스를 지정된 Guid 개체와 비교하여 상대 값의 표시를 반환합니다. Compares this instance to a specified Guid object and returns an indication of their relative values.

CompareTo(Object) CompareTo(Object) CompareTo(Object) CompareTo(Object)

이 인스턴스를 지정된 개체와 비교하여 상대 값의 표시를 반환합니다. Compares this instance to a specified object and returns an indication of their relative values.

Equals(Guid) Equals(Guid) Equals(Guid) Equals(Guid)

이 인스턴스의 값과 지정된 Guid 개체의 값이 같은지를 나타내는 값을 반환합니다. Returns a value indicating whether this instance and a specified Guid object represent the same value.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

@FSHO2@이 인스턴스가 지정한 개체와 같은지를 나타내는 값을 반환합니다. Returns a value that indicates whether this instance is equal to a specified object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

이 인스턴스의 해시 코드를 반환합니다. Returns the hash code for this instance.

NewGuid() NewGuid() NewGuid() NewGuid()

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

Parse(String) Parse(String) Parse(String) Parse(String)

GUID의 문자열 표현을 해당 Guid 구조체로 변환합니다. Converts the string representation of a GUID to the equivalent Guid structure.

Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>)
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>) ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>) ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>) ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>)
ParseExact(String, String) ParseExact(String, String) ParseExact(String, String) ParseExact(String, String)

문자열이 지정된 서식인 경우 GUID의 문자열 표현을 해당 Guid 구조체로 변환합니다. Converts the string representation of a GUID to the equivalent Guid structure, provided that the string is in the specified format.

ToByteArray() ToByteArray() ToByteArray() ToByteArray()

이 인스턴스의 값이 들어 있는, 16개 요소로 구성된 바이트 배열을 반환합니다. Returns a 16-element byte array that contains the value of this instance.

ToString() ToString() ToString() ToString()

레지스트리 형식의 이 인스턴스 값에 대한 문자열 표현을 반환합니다. Returns a string representation of the value of this instance in registry format.

ToString(String) ToString(String) ToString(String) ToString(String)

제공된 서식 지정자에 따라 이 Guid 인스턴스의 값에 대한 문자열 표현을 반환합니다. Returns a string representation of the value of this Guid instance, according to the provided format specifier.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

제공된 서식 지정자 및 문화권별 서식 정보에 따라 Guid 클래스의 이 인스턴스 값에 대한 문자열 표현을 반환합니다. Returns a string representation of the value of this instance of the Guid class, according to the provided format specifier and culture-specific format information.

TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>) TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>)
TryParse(ReadOnlySpan<Char>, Guid) TryParse(ReadOnlySpan<Char>, Guid) TryParse(ReadOnlySpan<Char>, Guid) TryParse(ReadOnlySpan<Char>, Guid)
TryParse(String, Guid) TryParse(String, Guid) TryParse(String, Guid) TryParse(String, Guid)

GUID의 문자열 표현을 해당 Guid 구조체로 변환합니다. Converts the string representation of a GUID to the equivalent Guid structure.

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid) TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid)
TryParseExact(String, String, Guid) TryParseExact(String, String, Guid) TryParseExact(String, String, Guid) TryParseExact(String, String, Guid)

문자열이 지정된 서식인 경우 GUID의 문자열 표현을 해당 Guid 구조체로 변환합니다. Converts the string representation of a GUID to the equivalent Guid structure, provided that the string is in the specified format.

TryWriteBytes(Span<Byte>) TryWriteBytes(Span<Byte>) TryWriteBytes(Span<Byte>) TryWriteBytes(Span<Byte>)

연산자

Equality(Guid, Guid) Equality(Guid, Guid) Equality(Guid, Guid) Equality(Guid, Guid)

지정된 두 Guid 개체의 값이 같은지 여부를 나타냅니다. Indicates whether the values of two specified Guid objects are equal.

Inequality(Guid, Guid) Inequality(Guid, Guid) Inequality(Guid, Guid) Inequality(Guid, Guid)

지정된 두 Guid 개체의 값이 같지 않은지 여부를 나타냅니다. Indicates whether the values of two specified Guid objects are not equal.

명시적 인터페이스 구현

IComparable.CompareTo(Object) IComparable.CompareTo(Object) IComparable.CompareTo(Object) IComparable.CompareTo(Object)
IFormattable.ToString(String, IFormatProvider) IFormattable.ToString(String, IFormatProvider) IFormattable.ToString(String, IFormatProvider) IFormattable.ToString(String, IFormatProvider)

적용 대상