Guid Guid Guid Guid Struct

Definition

Stellt eine GUID dar (Globally Unique Identifier, globaler eindeutiger Bezeichner).Represents a globally unique identifier (GUID).

public value class Guid : IComparable, IComparable<Guid>, IEquatable<Guid>, IFormattable
[System.Runtime.InteropServices.ComVisible(true)]
[System.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
Vererbung
Attribute
Implementiert

Beispiele

Im folgenden Beispiel wird die System.Runtime.InteropServices.GuidAttribute Klasse, um eine GUID einer Schnittstelle und eine benutzerdefinierte Klasse zugewiesen werden.The following example uses the System.Runtime.InteropServices.GuidAttribute class to assign a GUID to an interface and to a user-defined class. Der Wert der GUID abgerufen, durch den Aufruf der GetCustomAttribute -Methode, und vergleicht ihn mit zwei anderen GUIDs zu bestimmen, ob diese gleich sind.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

Beachten Sie, dass die GuidAttribute Attribut wird normalerweise in einer Anwendung verwendet, um einen Typ für COM verfügbar zu machenNote that the GuidAttribute attribute is typically used in an application to expose a type to COM. Wenn Sie dieses Beispiel zu kompilieren, können Sie Ausführen den Assembly Registration-Tool (Regasm.exe) für die generierte Assembly zum Erstellen von Registrierungsdatei (reg), und geben Sie Bibliotheksdateien (.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. Die REG-Datei kann verwendet werden, um die Co-Klasse in der Registrierung zu registrieren, und die TLB-Datei kann Metadaten für COM-Interop bereitstellen.The .reg file can be used to register the coclass in the registry, and the .tlb file can provide metadata for COM interop.

Hinweise

Eine GUID ist eine 128-Bit-Ganzzahl (16 Bytes), die für alle Computer und Netzwerke verwendet werden kann, wo ein eindeutiger Bezeichner erforderlich ist.A GUID is a 128-bit integer (16 bytes) that can be used across all computers and networks wherever a unique identifier is required. Ein solcher Bezeichner ist eine sehr geringe Wahrscheinlichkeit besteht, wird dupliziert.Such an identifier has a very low probability of being duplicated.

Konstruktoren

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

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des angegebenen Bytearrays.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)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des von der angegebenen Zeichenfolge dargestellten Werts.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[])

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.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)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.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(UInt32, UInt16, Byte, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte) Guid(UInt32, UInt16, Byte, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte) Guid(UInt32, UInt16, Byte, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.Initializes a new instance of the Guid structure by using the specified unsigned integers and bytes.

Felder

Empty Empty Empty Empty

Eine schreibgeschützte Instanz der Guid-Struktur, in der alle Werte 0 (null) sind.A read-only instance of the Guid structure whose value is all zeros.

Methoden

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

Vergleicht diese Instanz mit einem angegebenen Guid-Objekt und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.Compares this instance to a specified Guid object and returns an indication of their relative values.

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

Vergleicht diese Instanz mit einem angegebenen Objekt und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.Compares this instance to a specified object and returns an indication of their relative values.

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

Gibt einen Wert zurück, der angibt, ob diese Instanz und ein angegebenes Guid-Objekt den gleichen Wert darstellen.Returns a value indicating whether this instance and a specified Guid object represent the same value.

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

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.Returns a value that indicates whether this instance is equal to a specified object.

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

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

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

Initialisiert eine neue Instanz der Guid-Struktur.Initializes a new instance of the Guid structure.

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

Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid-Struktur.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)

Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid-Struktur, vorausgesetzt, dass die Zeichenfolge das angegebene Format hat.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()

Gibt ein aus 16 Elementen bestehendes Bytearray zurück, das den Wert dieser Instanz enthält.Returns a 16-element byte array that contains the value of this instance.

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

Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz im Registrierungsformat zurück.Returns a string representation of the value of this instance in registry format.

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

Gibt eine Zeichenfolgendarstellung des Werts dieser Guid-Instanz entsprechend dem angegebenen Formatbezeichner zurück.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)

Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz der Guid-Klasse entsprechend dem angegebenen Formatbezeichner und den angegebenen kulturspezifischen Formatinformationen zurück.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)

Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid-Struktur.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)

Konvertiert die Zeichenfolgendarstellung einer GUID in die entsprechende Guid-Struktur, vorausgesetzt, dass die Zeichenfolge das angegebene Format hat.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>)

Operatoren

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

Gibt an, ob die Werte von zwei angegebenen Guid-Objekten gleich sind.Indicates whether the values of two specified Guid objects are equal.

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

Gibt an, ob die Werte von zwei angegebenen Guid-Objekten gleich sind.Indicates whether the values of two specified Guid objects are not equal.

Explizite Schnittstellenimplementierungen

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)

Gibt eine Zeichenfolgendarstellung des Werts dieser Instanz entsprechend dem angegebenen Formatspezifizierer und den angegebenen kulturspezifischen Formatinformationen zurück.Returns a string representation of the value of this instance, according to the provided format specifier and culture-specific format information.

Gilt für: