Guid Конструкторы

Определение

Инициализирует новый экземпляр структуры Guid.Initializes a new instance of the Guid structure.

Перегрузки

Guid(Byte[])

Инициализирует новый экземпляр структуры Guid с использованием указанного массива байтов.Initializes a new instance of the Guid structure by using the specified array of bytes.

Guid(ReadOnlySpan<Byte>)

Инициализирует новый экземпляр структуры Guid с использованием значения, представленного заданным диапазоном байтов только для чтения.Initializes a new instance of the Guid structure by using the value represented by the specified read-only span of bytes.

Guid(String)

Инициализирует новый экземпляр структуры Guid с использованием значения, представленного заданной строкой.Initializes a new instance of the Guid structure by using the value represented by the specified string.

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

Инициализирует новый экземпляр структуры Guid с использованием заданных целых чисел и массива байтов.Initializes a new instance of the Guid structure by using the specified integers and byte array.

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

Инициализирует новый экземпляр структуры Guid с использованием заданных целых чисел и байтов.Initializes a new instance of the Guid structure by using the specified integers and bytes.

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

Инициализирует новый экземпляр структуры Guid с использованием указанных целых чисел без знака и байтов.Initializes a new instance of the Guid structure by using the specified unsigned integers and bytes.

Guid(Byte[])

Инициализирует новый экземпляр структуры Guid с использованием указанного массива байтов.Initializes a new instance of the Guid structure by using the specified array of bytes.

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

Параметры

b
Byte[]

Массив из 16 байтов содержит значения для инициализации GUID.A 16-element byte array containing values with which to initialize the GUID.

Исключения

b имеет значение null.b is null.

Размер b не равен 16 байтам.b is not 16 bytes long.

Guid(ReadOnlySpan<Byte>)

Инициализирует новый экземпляр структуры Guid с использованием значения, представленного заданным диапазоном байтов только для чтения.Initializes a new instance of the Guid structure by using the value represented by the specified read-only span of bytes.

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

Параметры

b
ReadOnlySpan<Byte>

Доступный только для чтения диапазон, содержащий байты, представляющие GUID.A read-only span containing the bytes representing the GUID. Диапазон должен иметь длину ровно 16 байт.The span must be exactly 16 bytes long.

Исключения

Диапазон должен иметь длину ровно 16 байт.The span must be exactly 16 bytes long.

Guid(String)

Инициализирует новый экземпляр структуры Guid с использованием значения, представленного заданной строкой.Initializes a new instance of the Guid structure by using the value represented by the specified string.

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

Параметры

g
String

Строка, содержащая GUID в одном из указанных ниже форматов (здесь "d" обозначает шестнадцатеричную цифру, регистр которой игнорируется).A string that contains a GUID in one of the following formats ("d" represents a hexadecimal digit whose case is ignored):

Непрерывная последовательность из 32 цифр:32 contiguous digits:

dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd

-или--or-

Группы из 8, 4, 4, 4 и 12 цифр с дефисами между группами.Groups of 8, 4, 4, 4, and 12 digits with hyphens between the groups. GUID целиком может быть заключен в фигурные или круглые скобки:The entire GUID can optionally be enclosed in matching braces or parentheses:

dddddddd-dddd-dddd-dddd-dddddddddddddddddddd-dddd-dddd-dddd-dddddddddddd

-или--or-

{dddddddd-dddd-dddd-dddd-dddddddddddd}{dddddddd-dddd-dddd-dddd-dddddddddddd}

-или--or-

(dddddddd-dddd-dddd-dddd-dddddddddddd)(dddddddd-dddd-dddd-dddd-dddddddddddd)

-или--or-

Группы из 8, 4 и 4 цифр и подмножество восьми групп по 2 цифры; все группы снабжены префиксом "0x" или "0X" и разделены запятыми.Groups of 8, 4, and 4 digits, and a subset of eight groups of 2 digits, with each group prefixed by "0x" or "0X", and separated by commas. Весь GUID, так же как и подмножество, заключается в фигурные скобки:The entire GUID, as well as the subset, is enclosed in matching braces:

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

Все фигурные скобки, запятые и префиксы "0x" необходимы.All braces, commas, and "0x" prefixes are required. Все внутренние пробелы игнорируются.All embedded spaces are ignored. Все нули в начале группы игнорируются.All leading zeros in a group are ignored.

Цифры, указанные в группе, определяют наибольшее количество значащих цифр в данной группе.The digits shown in a group are the maximum number of meaningful digits that can appear in that group. Можно задавать цифры от 1 до количества, указанного для группы.You can specify from 1 to the number of digits shown for a group. Предполагается, что задаваемые цифры являются младшими цифрами группы.The specified digits are assumed to be the low-order digits of the group.

Исключения

g имеет значение null.g is null.

Недопустимый формат g.The format of g is invalid.

Недопустимый формат g.The format of g is invalid.

Примеры

В следующем примере каждая строка, указанная в разделе "Примечания", передается конструктору Guid(String).The following example passes each string listed in the Remarks section to the Guid(String) constructor.

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

Комментарии

Шестнадцатеричные цифры в параметре g могут быть прописными или строчными буквами.The alphabetic hexadecimal digits in the g parameter can be uppercase or lowercase. Например, следующие строки представляют один и тот же GUID:For example, the following strings represent the same GUID:

"ca761232ed4211cebacd00aa0057b223""ca761232ed4211cebacd00aa0057b223"

"CA761232-ED42-11CE-BACD-00AA0057B223""CA761232-ED42-11CE-BACD-00AA0057B223"

"{CA761232-ED42-11CE-BACD-00AA0057B223}""{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}}""{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}"

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

Инициализирует новый экземпляр структуры Guid с использованием заданных целых чисел и массива байтов.Initializes a new instance of the Guid structure by using the specified integers and byte array.

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

Параметры

a
Int32

Первые 4 байта GUID.The first 4 bytes of the GUID.

b
Int16

Следующие 2 байта GUID.The next 2 bytes of the GUID.

c
Int16

Следующие 2 байта GUID.The next 2 bytes of the GUID.

d
Byte[]

Оставшиеся 8 байтов GUID.The remaining 8 bytes of the GUID.

Исключения

d имеет значение null.d is null.

Размер d не равен 8 байтам.d is not 8 bytes long.

Примеры

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) создает Guid, соответствующий "00000001-0002-0003-0001-020304050607".Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) creates a Guid that corresponds to "00000001-0002-0003-0001-020304050607".

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

Инициализирует новый экземпляр структуры Guid с использованием заданных целых чисел и байтов.Initializes a new instance of the Guid structure by using the specified integers and bytes.

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)

Параметры

a
Int32

Первые 4 байта GUID.The first 4 bytes of the GUID.

b
Int16

Следующие 2 байта GUID.The next 2 bytes of the GUID.

c
Int16

Следующие 2 байта GUID.The next 2 bytes of the GUID.

d
Byte

Следующий байт GUID.The next byte of the GUID.

e
Byte

Следующий байт GUID.The next byte of the GUID.

f
Byte

Следующий байт GUID.The next byte of the GUID.

g
Byte

Следующий байт GUID.The next byte of the GUID.

h
Byte

Следующий байт GUID.The next byte of the GUID.

i
Byte

Следующий байт GUID.The next byte of the GUID.

j
Byte

Следующий байт GUID.The next byte of the GUID.

k
Byte

Следующий байт GUID.The next byte of the GUID.

Примеры

В следующем примере создается идентификатор GUID, строковое представление которого — "0000000A-000B-000c-0001-020304050607".The following example creates a GUID whose string representation is "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}
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}

Комментарии

Указание отдельных байтов таким образом можно использовать для обхода ограничений порядка байтов (порядка байтов с обратным порядком байтов или с прямым порядком байт) на компьютерах определенных типов.Specifying individual bytes in this manner can be used to circumvent byte order restrictions (big-endian or little-endian byte order) on particular types of computers.

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

Важно!

Этот API несовместим с CLS.

Инициализирует новый экземпляр структуры Guid с использованием указанных целых чисел без знака и байтов.Initializes a new instance of the Guid structure by using the specified unsigned integers and bytes.

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

Параметры

a
UInt32

Первые 4 байта GUID.The first 4 bytes of the GUID.

b
UInt16

Следующие 2 байта GUID.The next 2 bytes of the GUID.

c
UInt16

Следующие 2 байта GUID.The next 2 bytes of the GUID.

d
Byte

Следующий байт GUID.The next byte of the GUID.

e
Byte

Следующий байт GUID.The next byte of the GUID.

f
Byte

Следующий байт GUID.The next byte of the GUID.

g
Byte

Следующий байт GUID.The next byte of the GUID.

h
Byte

Следующий байт GUID.The next byte of the GUID.

i
Byte

Следующий байт GUID.The next byte of the GUID.

j
Byte

Следующий байт GUID.The next byte of the GUID.

k
Byte

Следующий байт GUID.The next byte of the GUID.

Атрибуты

Примеры

GUID (0xA, 0xB, 0xC, 0, 1, 2, 3, 4, 5, 6, 7) создает Guid, соответствующий "0000000A-000B-000c-0001-020304050607".Guid(0xa,0xb,0xc,0,1,2,3,4,5,6,7) creates a Guid that corresponds to "0000000a-000b-000c-0001-020304050607".

Комментарии

Указание байтов таким образом позволяет избежать порядок следования байтов проблем.Specifying the bytes in this manner avoids endianness issues.

Применяется к