Guid Oluşturucular

  • Başvuru

Tanım

Ad Alanı:
System
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Yapının yeni bir örneğini Guid başlatır.

Aşırı Yüklemeler

Guid(Byte[])

Belirtilen bayt dizisini Guid kullanarak yapının yeni bir örneğini başlatır.
Guid(ReadOnlySpan<Byte>)

Belirtilen bayt salt okunur aralığıyla temsil edilen değeri kullanarak yapının yeni bir örneğini Guid başlatır.
Guid(String)

Belirtilen dizeyle temsil edilen değeri kullanarak yapının yeni bir örneğini Guid başlatır.
Guid(Int32, Int16, Int16, Byte[])

Belirtilen tamsayıları ve bayt dizisini Guid kullanarak yapının yeni bir örneğini başlatır.
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

Belirtilen tamsayıları ve baytları kullanarak yapının yeni bir örneğini Guid başlatır.
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

Belirtilen işaretsiz tamsayıları ve baytları kullanarak yapının yeni bir örneğini Guid başlatır.

Guid(Byte[])

Belirtilen bayt dizisini Guid kullanarak yapının yeni bir örneğini başlatır.

public:
 Guid(cli::array <System::Byte> ^ b);
public Guid (byte[] b);
new Guid : byte[] -> Guid
Public Sub New (b As Byte())

Parametreler

b
Byte[]

GUID'nin başlatıldığı değerleri içeren 16 öğeli bayt dizisi.

Özel durumlar

ArgumentNullException

b, null değeridir.

ArgumentException

b 16 bayt uzun değil.

Şunlara uygulanır

Guid(ReadOnlySpan<Byte>)

Belirtilen bayt salt okunur aralığıyla temsil edilen değeri kullanarak yapının yeni bir örneğini Guid başlatır.

public:
 Guid(ReadOnlySpan<System::Byte> b);
public Guid (ReadOnlySpan<byte> b);
new Guid : ReadOnlySpan<byte> -> Guid
Public Sub New (b As ReadOnlySpan(Of Byte))

Parametreler

b
ReadOnlySpan<Byte>

GUID'yi temsil eden baytları içeren salt okunur bir yayılma alanı. Yayılma alanı tam olarak 16 bayt uzunluğunda olmalıdır.

Özel durumlar

ArgumentException

Yayılma alanı tam olarak 16 bayt uzunluğunda olmalıdır.

Şunlara uygulanır

Guid(String)

Belirtilen dizeyle temsil edilen değeri kullanarak yapının yeni bir örneğini Guid başlatır.

public:
 Guid(System::String ^ g);
public Guid (string g);
new Guid : string -> Guid
Public Sub New (g As String)

Parametreler

g
String

Aşağıdaki biçimlerden birinde GUID içeren bir dize ("d" büyük/küçük harf yoksayılan onaltılık bir rakamı temsil eder):

32 bitişik onaltılık basamak:

ddddd

-veya-

Gruplar arasında kısa çizgilerle 8, 4, 4, 4 ve 12 onaltılık basamaklardan oluşan gruplar. GUID'nin tamamı isteğe bağlı olarak eşleşen ayraçlar veya parantezler içine alınabilir:

ddddddd-dddd-dddd-dddd-d

-veya-

{ddddd-dddd-dddd-dddd-d}

-veya-

(ddddddd-dddd-dddd-dddd-d)

-veya-

8, 4 ve 4 onaltılık basamak grupları ve her grup "0x" veya "0X" ön ekiyle ön ekli ve virgülle ayrılmış 2 onaltılık basamaklı sekiz grubun alt kümesi. Guid'nin tamamı ve alt küme ayraçları eşleşen ayraçlar içine alınır:

{0xdddddddd, 0xdddd, 0xdddd,{0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd}}

Tüm ayraçlar, virgüller ve "0x" ön ekleri gereklidir. Tüm eklenmiş alanlar yoksayılır. Bir gruptaki tüm baştaki sıfırlar yoksayılır.

Bir grupta gösterilen onaltılık basamaklar, bu grupta görünebilecek en fazla anlamlı onaltılık basamak sayısıdır. 1 ile bir grup için gösterilen onaltılık basamak sayısını belirtebilirsiniz. Belirtilen basamakların grubun düşük sıralı basamakları olduğu varsayılır.

Özel durumlar

ArgumentNullException

g, null değeridir.

FormatException

biçimi g geçersiz.

OverflowException

biçimi g geçersiz.

Örnekler

Aşağıdaki örnek, Açıklamalar bölümünde listelenen her dizeyi oluşturucuya Guid(String) geçirir.

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

Açıklamalar

Parametresindeki g alfabetik onaltılık basamaklar büyük veya küçük harf olabilir. Örneğin, aşağıdaki dizeler aynı GUID'yi temsil eder:

"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}}"

Şunlara uygulanır

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

Belirtilen tamsayıları ve bayt dizisini Guid kullanarak yapının yeni bir örneğini başlatır.

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())

Parametreler

a
Int32

GUID'nin ilk 4 bayt.

b
Int16

GUID'nin sonraki 2 baytı.

c
Int16

GUID'nin sonraki 2 baytı.

d
Byte[]

GUID'nin kalan 8 baytı.

Özel durumlar

ArgumentNullException

d, null değeridir.

ArgumentException

d 8 bayt uzun değil.

Örnekler

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) "00000001-0002-0003-0001-020304050607" öğesine karşılık gelen bir Guid oluşturur.

Şunlara uygulanır

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

Belirtilen tamsayıları ve baytları kullanarak yapının yeni bir örneğini Guid başlatır.

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)

Parametreler

a
Int32

GUID'nin ilk 4 bayt.

b
Int16

GUID'nin sonraki 2 baytı.

c
Int16

GUID'nin sonraki 2 baytı.

d
Byte

GUID'nin sonraki baytı.

e
Byte

GUID'nin sonraki baytı.

f
Byte

GUID'nin sonraki baytı.

g
Byte

GUID'nin sonraki baytı.

h
Byte

GUID'nin sonraki baytı.

i
Byte

GUID'nin sonraki baytı.

j
Byte

GUID'nin sonraki baytı.

k
Byte

GUID'nin sonraki baytı.

Örnekler

Aşağıdaki örnek, dize gösterimi "0000000a-000b-000c-0001-020304050607" olan bir GUID oluşturur.

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}

Açıklamalar

Belirli bilgisayar türlerinde bayt sırası kısıtlamalarını (big-endian veya little-endian bayt sırası) aşmak için tek tek baytları bu şekilde belirtmek kullanılabilir.

Şunlara uygulanır

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

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen işaretsiz tamsayıları ve baytları kullanarak yapının yeni bir örneğini Guid başlatır.

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)

Parametreler

a
UInt32

GUID'nin ilk 4 bayt.

b
UInt16

GUID'nin sonraki 2 baytı.

c
UInt16

GUID'nin sonraki 2 baytı.

d
Byte

GUID'nin sonraki baytı.

e
Byte

GUID'nin sonraki baytı.

f
Byte

GUID'nin sonraki baytı.

g
Byte

GUID'nin sonraki baytı.

h
Byte

GUID'nin sonraki baytı.

i
Byte

GUID'nin sonraki baytı.

j
Byte

GUID'nin sonraki baytı.

k
Byte

GUID'nin sonraki baytı.

Öznitelikler
CLSCompliantAttribute

Açıklamalar

Baytların bu şekilde belirtilmesi, endianness sorunlarını önler.

Şunlara uygulanır