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

Определение

Пространство имен:: System

Сборки:: mscorlib.dll, System.Runtime.dll

Сборки:: netstandard.dll, System.Runtime.dll

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Инициализирует новый экземпляр Guid структуры.

Перегрузки

Имя	Описание
Guid(Byte[])	Инициализирует новый экземпляр Guid структуры с помощью указанного массива байтов.
Guid(ReadOnlySpan<Byte>)	Инициализирует новый экземпляр Guid структуры с помощью значения, представленного указанным диапазоном байтов только для чтения.
Guid(String)	Инициализирует новый экземпляр Guid структуры с помощью значения, представленного указанной строкой.
Guid(ReadOnlySpan<Byte>, Boolean)	Инициализирует новый экземпляр Guid структуры с помощью значения, представленного указанным диапазоном байтов только для чтения и указанной конечностью.
Guid(Int32, Int16, Int16, Byte[])	Инициализирует новый экземпляр Guid структуры с помощью указанных целых чисел и массива байтов.
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	Инициализирует новый экземпляр Guid структуры с помощью указанных целых чисел и байтов.
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	Инициализирует новый экземпляр Guid структуры с помощью указанных целых чисел без знака и байтов.

Guid(Byte[])

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Инициализирует новый экземпляр Guid структуры с помощью указанного массива байтов.

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.

Исключения

ArgumentNullException

b равно null.

ArgumentException

b не составляет 16 байтов.

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

Guid(ReadOnlySpan<Byte>)

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Инициализирует новый экземпляр Guid структуры с помощью значения, представленного указанным диапазоном байтов только для чтения.

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. Диапазон должен составлять ровно 16 байтов.

Исключения

ArgumentException

Диапазон должен составлять ровно 16 байтов.

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

Guid(String)

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Инициализирует новый экземпляр Guid структуры с помощью значения, представленного указанной строкой.

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

public Guid(string g);

new Guid : string -> Guid

Public Sub New (g As String)

Параметры

g: String

Строка, содержащая GUID в одном из следующих форматов ("d" представляет шестнадцатеричную цифру, регистр которой игнорируется):

32 смежных шестнадцатеричных цифр:

–или–

Группы из 8, 4, 4, 4 и 12 шестнадцатеричных цифр с дефисом между группами. При необходимости весь GUID может быть заключен в соответствующие скобки или скобки:

d-d-d-d

–или–

{dd-d-d-d}

–или–

(d-d-d-d)

–или–

Группы из 8, 4 и 4 шестнадцатеричных цифр и подмножество из восьми групп из 2 шестнадцатеричных цифр, с каждой группой с префиксом "0x" или "0X" и разделено запятыми. Весь GUID, а также подмножество заключен в соответствующие скобки:

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

Требуются все фигурные скобки, запятые и префиксы "0x". Все внедренные пространства игнорируются. Все начальные нули в группе игнорируются.

Шестнадцатеричные цифры, отображаемые в группе, являются максимальным числом шестнадцатеричных цифр, которые могут отображаться в этой группе. Можно указать от 1 до числа шестнадцатеричных цифр, отображаемых для группы. Указанные цифры считаются низкими цифрами группы.

Исключения

ArgumentNullException

g равно null.

FormatException

Недопустимый g формат.

OverflowException

Недопустимый g формат.

Примеры

В следующем примере каждая строка, указанная в разделе "Примечания", передается конструктору 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

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

Guid(ReadOnlySpan<Byte>, Boolean)

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Инициализирует новый экземпляр Guid структуры с помощью значения, представленного указанным диапазоном байтов только для чтения и указанной конечностью.

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)

Параметры

b: ReadOnlySpan<Byte>

Диапазон только для чтения 16 элементов, содержащий байты, с которыми инициализировать GUID.

bigEndian: Boolean

true интерпретировать b как большой эндиан; false интерпретировать его как маленький эндиан.

Исключения

ArgumentException

b не составляет 16 байтов.

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

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

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Инициализирует новый экземпляр Guid структуры с помощью указанных целых чисел и массива байтов.

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.

b: Int16

Следующие 2 байта GUID.

c: Int16

Следующие 2 байта GUID.

d: Byte[]

Оставшиеся 8 байтов GUID.

Исключения

ArgumentNullException

d равно null.

ArgumentException

d не составляет 8 байтов.

Примеры

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

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

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

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Инициализирует новый экземпляр Guid структуры с помощью указанных целых чисел и байтов.

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.

b: Int16

Следующие 2 байта GUID.

c: Int16

Следующие 2 байта GUID.

d: Byte

Следующий байт GUID.

e: Byte

Следующий байт GUID.

f: Byte

Следующий байт GUID.

g: Byte

Следующий байт GUID.

h: Byte

Следующий байт GUID.

i: Byte

Следующий байт GUID.

j: Byte

Следующий байт GUID.

k: Byte

Следующий байт GUID.

Примеры

В следующем примере создается GUID, строковое представление которого равно "000000a-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}

Указание отдельных байтов таким образом можно использовать для обхода ограничений порядка байтов (большого или маленького байтового порядка) на определенных типах компьютеров.

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

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

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Исходный код:: Guid.cs

Важно!

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

Инициализирует новый экземпляр Guid структуры с помощью указанных целых чисел без знака и байтов.

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)

Параметры

a: UInt32

Первые 4 байта GUID.

b: UInt16

Следующие 2 байта GUID.

c: UInt16

Следующие 2 байта GUID.

d: Byte

Следующий байт GUID.

e: Byte

Следующий байт GUID.

f: Byte

Следующий байт GUID.

g: Byte

Следующий байт GUID.

h: Byte

Следующий байт GUID.

i: Byte

Следующий байт GUID.

j: Byte

Следующий байт GUID.

k: Byte

Следующий байт GUID.

Атрибуты: CLSCompliantAttribute

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

Обратная связь

Были ли сведения на этой странице полезными?

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

Определение

Перегрузки

Guid(Byte[])

Параметры

Исключения

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

Guid(ReadOnlySpan<Byte>)

Параметры

Исключения

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

Guid(String)

Параметры

Исключения

Примеры

Комментарии

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

Guid(ReadOnlySpan<Byte>, Boolean)

Параметры

Исключения

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

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

Параметры

Исключения

Примеры

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

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

Параметры

Примеры

Комментарии

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

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

Параметры

Комментарии

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