Guid Konstruktory

Definice

Obor názvů:: System

Sestavení:: mscorlib.dll, System.Runtime.dll

Sestavení:: netstandard.dll, System.Runtime.dll

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í

Name	Description
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 jen pro čtení bajtů.
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 struktury pomocí zadaných Guid celých čísel a bajtového 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 struktury pomocí zadaných celých Guid čísel a bajtů bez znaménka.

Guid(Byte[])

Zdroj:: Guid.cs

Zdroj:: Guid.cs

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 prvků bajtů obsahující hodnoty, se kterými se má inicializovat identifikátor GUID.

Výjimky

ArgumentNullException

b je null.

ArgumentException

b není dlouhý 16 bajtů.

Platí pro

Guid(ReadOnlySpan<Byte>)

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Zdroj:: Guid.cs

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

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. Rozsah musí být přesně 16 bajtů dlouhý.

Výjimky

ArgumentException

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

Platí pro

Guid(String)

Zdroj:: Guid.cs

Zdroj:: Guid.cs

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íž případ je ignorován):

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

nebo

Skupiny 8, 4, 4, 4 a 12 šestnáctkových číslic se spojovníky mezi skupinami Celý identifikátor GUID lze volitelně uzavřít do složených závorek nebo závorek:

dd-dddd-d-d

nebo

{ddd-dddd-dddd-d-dd}

nebo

(ddd-dddd-dddd-d)

nebo

Skupiny 8, 4 a 4 šestnáctkových číslic a podmnožina osmi skupin 2 šestnáctkových číslic s každou skupinou s předponou 0x nebo 0X a oddělená čárkami. Celý identifikátor GUID i podmnožina je uzavřen do shodných složený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í.

Šestnáctkové číslice zobrazené ve skupině představují maximální počet smysluplných šestnáctkových číslic, které se můžou zobrazit v dané skupině. Můžete zadat od 1 do počtu šestnáctkových číslic zobrazených pro skupinu. Zadané číslice se předpokládají jako číslice s nízkým pořadím skupiny.

Výjimky

ArgumentNullException

g je null.

FormatException

Formát g je neplatný.

OverflowException

Formát 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 můžou 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

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

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Inicializuje novou instanci struktury pomocí zadaných Guid celých čísel a bajtového 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ích 4 bajtů 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 není dlouhý 8 bajtů.

Příklady

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) Guid vytvoří odpovídající "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

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ích 4 bajtů 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

Určení jednotlivých bajtů tímto způsobem lze použít k obcházení omezení pořadí bajtů (big-endian nebo little-endian byte order) 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

Zdroj:: Guid.cs

Zdroj:: Guid.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci struktury pomocí zadaných celých Guid čí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ích 4 bajtů 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 zabráníte problémům s endianness.

Platí pro

Váš názor

Byla tato stránka užitečná?