Guid Konstruktory

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Inicializuje novou instanci Guid struktury.

Přetížení

Guid(Byte[])	Inicializuje novou instanci Guid struktury pomocí zadané pole bajtů.
Guid(ReadOnlySpan<Byte>)	Inicializuje novou instanci Guid struktury pomocí hodnoty reprezentované zadaným rozsahem bajtů jen pro čtení.
Guid(String)	Inicializuje novou instanci Guid struktury pomocí hodnoty reprezentované zadaným řetězcem.
Guid(ReadOnlySpan<Byte>, Boolean)
Guid(Int32, Int16, Int16, Byte[])	Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů pole.
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů.
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů bez znaménka.

Guid(Byte[])

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Inicializuje novou instanci Guid struktury pomocí zadané pole bajtů.

public:
 Guid(cli::array <System::Byte> ^ b);

public Guid (byte[] b);

new Guid : byte[] -> Guid

Public Sub New (b As Byte())

Parametry

b: Byte[]

Pole 16 bajtů obsahující hodnoty, pomocí kterých se má inicializovat identifikátor GUID.

Výjimky

ArgumentNullException

b je null.

ArgumentException

b nemá délku 16 bajtů.

Platí pro

Guid(ReadOnlySpan<Byte>)

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Inicializuje novou instanci Guid struktury pomocí hodnoty reprezentované zadaným rozsahem bajtů jen pro čtení.

public:
 Guid(ReadOnlySpan<System::Byte> b);

public Guid (ReadOnlySpan<byte> b);

new Guid : ReadOnlySpan<byte> -> Guid

Public Sub New (b As ReadOnlySpan(Of Byte))

Parametry

b: ReadOnlySpan<Byte>

Rozsah jen pro čtení obsahující bajty představující identifikátor GUID. Rozpětí musí být přesně 16 bajtů dlouhé.

Výjimky

ArgumentException

Rozpětí musí být přesně 16 bajtů dlouhé.

Platí pro

Guid(String)

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Inicializuje novou instanci Guid struktury pomocí hodnoty reprezentované zadaným řetězcem.

public:
 Guid(System::String ^ g);

public Guid (string g);

new Guid : string -> Guid

Public Sub New (g As String)

Parametry

g: String

Řetězec, který obsahuje identifikátor GUID v jednom z následujících formátů ("d" představuje šestnáctkovou číslici, jejíž malá a velká písmena jsou ignorována):

32 souvislých šestnáctkových číslic:

ddddddddd

-nebo-

Skupiny 8, 4, 4, 4 a 12 šestnáctkových číslic se spojovníky mezi skupinami. Celý identifikátor GUID může být volitelně uzavřený do odpovídajících závorek nebo závorek:

ddddddddd-ddddd-ddddd-dddddddddddd

-nebo-

{ddddddddd-dddd-ddddd-ddddddddddddddd}

-nebo-

(ddddddddd-dddd-ddddd-dddddddddddd)

-nebo-

Skupiny s 8, 4 a 4 šestnáctkovými číslicemi a podmnožinou osmi skupin po 2 šestnáctkových číslicích, přičemž každá skupina má předponu "0x" nebo "0X" a oddělenou čárkami. Celý identifikátor GUID i podmnožina jsou uzavřeny do odpovídajících závorek:

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

Všechny složené závorky, čárky a předpony "0x" jsou povinné. Všechny vložené mezery se ignorují. Všechny úvodní nuly ve skupině se ignorují.

Hexadecimální číslice zobrazené ve skupině představují maximální počet smysluplných šestnáctkových číslic, které se můžou v této skupině objevit. Můžete zadat hodnotu od 1 po počet šestnáctkových číslic zobrazených pro skupinu. Zadaná číslice jsou považovány za číslice s nízkým pořadím ve skupině.

Výjimky

ArgumentNullException

g je null.

FormatException

Formát parametru g je neplatný.

OverflowException

Formát parametru g je neplatný.

Příklady

Následující příklad předá každý řetězec uvedený v oddílu Poznámky konstruktoru 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

Poznámky

Abecední šestnáctkové číslice v parametru g mohou být velká nebo malá písmena. Například následující řetězce představují stejný identifikátor 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}}"

Platí pro

Guid(ReadOnlySpan<Byte>, Boolean)

Zdroj:: Guid.cs

Zdroj:: 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)

Parametry

b: ReadOnlySpan<Byte>

bigEndian: Boolean

Platí pro

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

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů pole.

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

Parametry

a: Int32

První 4 bajty identifikátoru GUID.

b: Int16

Další 2 bajty identifikátoru GUID.

c: Int16

Další 2 bajty identifikátoru GUID.

d: Byte[]

Zbývajících 8 bajtů identifikátoru GUID

Výjimky

ArgumentNullException

d je null.

ArgumentException

d nemá délku 8 bajtů.

Příklady

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) vytvoří , Guid který odpovídá "00000001-0002-0003-0001-020304050607".

Platí pro

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

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů.

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)

Parametry

a: Int32

První 4 bajty identifikátoru GUID.

b: Int16

Další 2 bajty identifikátoru GUID.

c: Int16

Další 2 bajty identifikátoru GUID.

d: Byte

Další bajt identifikátoru GUID.

e: Byte

Další bajt identifikátoru GUID.

f: Byte

Další bajt identifikátoru GUID.

g: Byte

Další bajt identifikátoru GUID.

h: Byte

Další bajt identifikátoru GUID.

i: Byte

Další bajt identifikátoru GUID.

j: Byte

Další bajt identifikátoru GUID.

k: Byte

Další bajt identifikátoru GUID.

Příklady

Následující příklad vytvoří identifikátor GUID, jehož řetězcové vyjádření je "0000000a-000b-000c-0001-020304050607".

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}

Poznámky

Zadáním jednotlivých bajtů tímto způsobem lze obejít omezení pořadí bajtů (pořadí bajtů big-endian nebo little-endian) na konkrétních typech počítačů.

Platí pro

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

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů bez znaménka.

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)

Parametry

a: UInt32

První 4 bajty identifikátoru GUID.

b: UInt16

Další 2 bajty identifikátoru GUID.

c: UInt16

Další 2 bajty identifikátoru GUID.

d: Byte

Další bajt identifikátoru GUID.

e: Byte

Další bajt identifikátoru GUID.

f: Byte

Další bajt identifikátoru GUID.

g: Byte

Další bajt identifikátoru GUID.

h: Byte

Další bajt identifikátoru GUID.

i: Byte

Další bajt identifikátoru GUID.

j: Byte

Další bajt identifikátoru GUID.

k: Byte

Další bajt identifikátoru GUID.

Atributy: CLSCompliantAttribute

Poznámky

Zadáním bajtů tímto způsobem se vyhnete problémům s koncovostí.

Platí pro

Sdílet prostřednictvím

Guid Konstruktory

Definice

Přetížení

Guid(Byte[])

Parametry

Výjimky

Platí pro

Guid(ReadOnlySpan<Byte>)

Parametry

Výjimky

Platí pro

Guid(String)

Parametry

Výjimky

Příklady

Poznámky

Platí pro

Guid(ReadOnlySpan<Byte>, Boolean)

Parametry

Platí pro

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

Parametry

Výjimky

Příklady

Platí pro

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

Parametry

Příklady

Poznámky

Platí pro

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

Parametry

Poznámky

Platí pro

Další materiály