Guid Konstruktorer

Definition

Namnområde:: System

Sammansättningar:: mscorlib.dll, System.Runtime.dll

Sammansättningar:: netstandard.dll, System.Runtime.dll

Sammansättning:: System.Runtime.dll

Sammansättning:: mscorlib.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Initierar en ny instans av Guid strukturen.

Överlagringar

Name	Description
Guid(Byte[])	Initierar en ny instans av Guid strukturen med hjälp av den angivna bytematrisen.
Guid(ReadOnlySpan<Byte>)	Initierar en ny instans av Guid strukturen med hjälp av värdet som representeras av det angivna skrivskyddade intervallet med byte.
Guid(String)	Initierar en ny instans av Guid strukturen med hjälp av värdet som representeras av den angivna strängen.
Guid(ReadOnlySpan<Byte>, Boolean)
Guid(Int32, Int16, Int16, Byte[])	Initierar en ny instans av Guid strukturen med hjälp av de angivna heltalen och bytematrisen.
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	Initierar en ny instans av Guid strukturen med hjälp av de angivna heltalen och byteen.
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	Initierar en ny instans av Guid strukturen med hjälp av de angivna osignerade heltalen och byteen.

Guid(Byte[])

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Initierar en ny instans av Guid strukturen med hjälp av den angivna bytematrisen.

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

public Guid(byte[] b);

new Guid : byte[] -> Guid

Public Sub New (b As Byte())

Parametrar

b: Byte[]

En 16-elements bytematris som innehåller värden som GUID ska initieras med.

Undantag

ArgumentNullException

b är null.

ArgumentException

b är inte 16 byte långt.

Gäller för

Guid(ReadOnlySpan<Byte>)

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Initierar en ny instans av Guid strukturen med hjälp av värdet som representeras av det angivna skrivskyddade intervallet med byte.

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

public Guid(ReadOnlySpan<byte> b);

new Guid : ReadOnlySpan<byte> -> Guid

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

Parametrar

b: ReadOnlySpan<Byte>

Ett skrivskyddat intervall som innehåller byte som representerar GUID. Intervallet måste vara exakt 16 byte långt.

Undantag

ArgumentException

Intervallet måste vara exakt 16 byte långt.

Gäller för

Guid(String)

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Initierar en ny instans av Guid strukturen med hjälp av värdet som representeras av den angivna strängen.

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

public Guid(string g);

new Guid : string -> Guid

Public Sub New (g As String)

Parametrar

g: String

En sträng som innehåller ett GUID i något av följande format ("d" representerar en hexadecimal siffra vars skiftläge ignoreras):

32 sammanhängande hexadecimala siffror:

dddddddddddddddddd

-eller-

Grupper med 8, 4, 4, 4 och 12 hexadecimala siffror med bindestreck mellan grupperna. Hela GUID kan omges av matchande klammerparenteser eller parenteser:

ddddddddd-dddd-dddd-dddd-ddddddd

-eller-

{ddddddddd-dddd-dddd-dddd-dddddddd}

-eller-

(ddddddddd-dddd-dddd-dddd-dddddddd)

-eller-

Grupper med 8, 4 och 4 hexadecimala siffror och en delmängd av åtta grupper med 2 hexadecimala siffror, med varje grupp prefix med "0x" eller "0X", och avgränsade med kommatecken. Hela GUID:n samt delmängden omges av matchande klammerparenteser:

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

Alla klammerparenteser, kommatecken och "0x"-prefix krävs. Alla inbäddade blanksteg ignoreras. Alla inledande nollor i en grupp ignoreras.

De hexadecimala siffror som visas i en grupp är det maximala antalet meningsfulla hexadecimala siffror som kan visas i gruppen. Du kan ange från 1 till antalet hexadecimala siffror som visas för en grupp. De angivna siffrorna antas vara lågordningssiffriga siffror i gruppen.

Undantag

ArgumentNullException

g är null.

FormatException

Formatet g för är ogiltigt.

OverflowException

Formatet g för är ogiltigt.

Exempel

I följande exempel skickas varje sträng som anges i avsnittet Kommentarer till Guid(String) konstruktorn.

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

Kommentarer

De alfabetiska hexadecimala siffrorna i parametern g kan vara versaler eller gemener. Följande strängar representerar till exempel samma 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}}"

Gäller för

Guid(ReadOnlySpan<Byte>, Boolean)

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: 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)

Parametrar

b: ReadOnlySpan<Byte>

bigEndian: Boolean

Gäller för

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

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Initierar en ny instans av Guid strukturen med hjälp av de angivna heltalen och bytematrisen.

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

Parametrar

a: Int32

De första 4 byteen av GUID.

b: Int16

Nästa 2 byte av GUID.

c: Int16

Nästa 2 byte av GUID.

d: Byte[]

Återstående 8 byte av GUID.

Undantag

ArgumentNullException

d är null.

ArgumentException

d är inte 8 byte lång.

Exempel

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) skapar en Guid som motsvarar "000000001-0002-0003-0001-020304050607".

Gäller för

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

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Initierar en ny instans av Guid strukturen med hjälp av de angivna heltalen och byteen.

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)

Parametrar

a: Int32

De första 4 byteen av GUID.

b: Int16

Nästa 2 byte av GUID.

c: Int16

Nästa 2 byte av GUID.

d: Byte

Nästa byte av GUID.

e: Byte

Nästa byte av GUID.

f: Byte

Nästa byte av GUID.

g: Byte

Nästa byte av GUID.

h: Byte

Nästa byte av GUID.

i: Byte

Nästa byte av GUID.

j: Byte

Nästa byte av GUID.

k: Byte

Nästa byte av GUID.

Exempel

I följande exempel skapas ett GUID vars strängrepresentation är "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}

Kommentarer

Att ange enskilda byte på det här sättet kan användas för att kringgå byteordningsbegränsningar (storslutsordning eller lite endiansk byteordning) på vissa typer av datorer.

Gäller för

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

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Källa:: Guid.cs

Viktigt!

Detta API uppfyller inte CLS.

Initierar en ny instans av Guid strukturen med hjälp av de angivna osignerade heltalen och byteen.

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)

Parametrar

a: UInt32

De första 4 byteen av GUID.

b: UInt16

Nästa 2 byte av GUID.

c: UInt16

Nästa 2 byte av GUID.

d: Byte

Nästa byte av GUID.

e: Byte

Nästa byte av GUID.

f: Byte

Nästa byte av GUID.

g: Byte

Nästa byte av GUID.

h: Byte

Nästa byte av GUID.

i: Byte

Nästa byte av GUID.

j: Byte

Nästa byte av GUID.

k: Byte

Nästa byte av GUID.

Attribut: CLSCompliantAttribute

Kommentarer

Om du anger byte på det här sättet undviks problem med endianitet.

Gäller för

Feedback

Var den här sidan till hjälp?