Guid 結構

定義

命名空間:

System

組件:

netstandard.dll, System.Runtime.dll

來源:

Guid.cs

表示全域唯一標識碼 （GUID）。

public value class Guid : IComparable, IComparable<Guid>, IEquatable<Guid>, IParsable<Guid>, ISpanFormattable, ISpanParsable<Guid>, IUtf8SpanFormattable, IUtf8SpanParsable<Guid>

public readonly struct Guid : IComparable, IComparable<Guid>, IEquatable<Guid>, IParsable<Guid>, ISpanFormattable, ISpanParsable<Guid>, IUtf8SpanFormattable, IUtf8SpanParsable<Guid>

type Guid = struct
    interface IFormattable
    interface IParsable<Guid>
    interface ISpanFormattable
    interface ISpanParsable<Guid>
    interface IUtf8SpanFormattable
    interface IUtf8SpanParsable<Guid>

Public Structure Guid
Implements IComparable, IComparable(Of Guid), IEquatable(Of Guid), IParsable(Of Guid), ISpanFormattable, ISpanParsable(Of Guid), IUtf8SpanFormattable, IUtf8SpanParsable(Of Guid)

繼承

Object

ValueType

Guid

實作

IComparable IComparable<Guid> IEquatable<Guid> IFormattable IParsable<Guid> IParsable<TSelf> ISpanFormattable ISpanParsable<Guid> IUtf8SpanFormattable IUtf8SpanParsable<Guid>

備註

GUID 是一個 128 位元整數（16 位元組），可在所有需要唯一識別碼的電腦與網路間使用。 此類識別碼被重複的機率非常低。

建構函式

名稱	Description
Guid(Byte[])	使用指定的位元組陣列初始化結構的新實例 Guid 。
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	透過使用指定的整數與位元組初始化結構的新實例 Guid 。
Guid(Int32, Int16, Int16, Byte[])	透過使用指定的整數與位元組陣列初始化結構的新實例 Guid 。
Guid(ReadOnlySpan<Byte>, Boolean)	表示全域唯一標識碼 （GUID）。
Guid(ReadOnlySpan<Byte>)	利用指定的唯讀位元組區間所代表的值初始化結構的新 Guid 實例。
Guid(String)	使用指定字串所代表的值初始化結構的新 Guid 實例。
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	透過使用指定的無符號整數與位元組初始化結構的新 Guid 實例。

欄位

名稱	Description
Empty	結構的唯讀實例 Guid ，其值全部為零。

屬性

名稱	Description
AllBitsSet	會得到 Guid 一個所有位元都設定好的。
Variant	取得變體域的值。Guid
Version	取得 的版本欄位值為 Guid。

方法

名稱	Description
CompareTo(Guid)	將此實例與指定 Guid 物件比較，並回傳其相對值的指示。
CompareTo(Object)	比較這個實例與指定的物件，並傳回其相對值的指示。
CreateVersion7()	依據 RFC 9562 依照第 7 版格式建立新 Guid 版本。
CreateVersion7(DateTimeOffset)	依據 RFC 9562 依照第 7 版格式建立新 Guid 版本。
Equals(Guid)	回傳一個值，表示該實例與指定 Guid 物件是否代表相同值。
Equals(Object)	傳回值，這個值表示這個實例是否等於指定的物件。
GetHashCode()	傳回這個實例的哈希碼。
NewGuid()	初始化結構的新實例 Guid 。
Parse(ReadOnlySpan<Byte>, IFormatProvider)	將UTF-8字元的範圍剖析為值。
Parse(ReadOnlySpan<Byte>)	表示全域唯一標識碼 （GUID）。
Parse(ReadOnlySpan<Char>, IFormatProvider)	將字元範圍剖析為值。
Parse(ReadOnlySpan<Char>)	將代表 GUID 的唯讀字元區間轉換為等效 Guid 的結構。
Parse(String, IFormatProvider)	將字串剖析成值。
Parse(String)	將 GUID 的字串表示轉換為等價 Guid 結構。
ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>)	將 GUID 的字元區間表示轉換為等效 Guid 結構，前提是字串格式符合指定格式。
ParseExact(String, String)	將 GUID 的字串表示轉換為等效 Guid 結構，前提是字串格式符合指定。
ToByteArray()	回傳一個包含此實例值的 16 元素位元組陣列。
ToByteArray(Boolean)	表示全域唯一標識碼 （GUID）。
ToString()	回傳該實例值的字串表示，以登錄格式呈現。
ToString(String, IFormatProvider)	回傳該類別實例 Guid 值的字串表示，依據所提供的格式規範符及文化特定格式資訊。
ToString(String)	回傳根據所提供格式規範符，回傳該 Guid 實例值的字串表示。
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>)	表示全域唯一標識碼 （GUID）。
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>)	嘗試將目前的 GUID 實例格式化為提供的字元區間。
TryParse(ReadOnlySpan<Byte>, Guid)	表示全域唯一標識碼 （GUID）。
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Guid)	嘗試將UTF-8字元的範圍剖析為值。
TryParse(ReadOnlySpan<Char>, Guid)	將包含 GUID 表示的指定唯讀字元範圍轉換為等效 Guid 結構。
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)	嘗試將字元範圍剖析成值。
TryParse(String, Guid)	將 GUID 的字串表示轉換為等價 Guid 結構。
TryParse(String, IFormatProvider, Guid)	嘗試將字串剖析成值。
TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid)	將代表 GUID 的字元範圍轉換為等效 Guid 結構，前提是字串符合指定格式。
TryParseExact(String, String, Guid)	將 GUID 的字串表示轉換為等效 Guid 結構，前提是字串格式符合指定。
TryWriteBytes(Span<Byte>, Boolean, Int32)	表示全域唯一標識碼 （GUID）。
TryWriteBytes(Span<Byte>)	嘗試將目前的 GUID 實例寫入一個位元組區間。

操作員

名稱	Description
Equality(Guid, Guid)	表示兩個指定 Guid 物件的值是否相等。
GreaterThan(Guid, Guid)	比較兩個值，以判斷哪一個值更大。
GreaterThanOrEqual(Guid, Guid)	比較兩個值，以判斷哪一個值大於或相等。
Inequality(Guid, Guid)	表示兩個指定 Guid 物件的值是否不相等。
LessThan(Guid, Guid)	比較兩個值，以判斷哪一個值較少。
LessThanOrEqual(Guid, Guid)	比較兩個值，以判斷哪一個值小於或相等。

明確介面實作

名稱	Description
ISpanFormattable.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	嘗試將目前實例的值格式化為提供的字元範圍。
IUtf8SpanFormattable.TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	嘗試將目前實例的值格式化為UTF-8到提供的位元組範圍。