AsnReader.ReadNamedBitListValue 方法

定義

命名空間:

System.Formats.Asn1

組件:

System.Formats.Asn1.dll

多載

ReadNamedBitListValue(Type, Nullable<Asn1Tag>)	讀取下一個值做為具有所指定標籤的 NamedBitList，同時將其轉換為 flagsEnumType 所指定的 [FlagsAttribute] 列舉。
ReadNamedBitListValue<TFlagsEnum>(Nullable<Asn1Tag>)	讀取下一個值做為具有所指定標籤的 NamedBitList，同時將其轉換為 TFlagsEnum 所指定的 [FlagsAttribute] 列舉。

ReadNamedBitListValue(Type, Nullable<Asn1Tag>)

來源:

AsnDecoder.NamedBitList.cs

讀取下一個值做為具有所指定標籤的 NamedBitList，同時將其轉換為 flagsEnumType 所指定的 [FlagsAttribute] 列舉。

public Enum ReadNamedBitListValue (Type flagsEnumType, System.Formats.Asn1.Asn1Tag? expectedTag = default);

member this.ReadNamedBitListValue : Type * Nullable<System.Formats.Asn1.Asn1Tag> -> Enum

Public Function ReadNamedBitListValue (flagsEnumType As Type, Optional expectedTag As Nullable(Of Asn1Tag) = Nothing) As Enum

參數

flagsEnumType

Type

代表目的型別的 Type 物件。

expectedTag

Nullable<Asn1Tag>

要在讀取之前檢查的標籤。

傳回

Enum

轉換成 flagsEnumType 的 NamedBitList 值。

例外狀況

AsnContentException

下一個值沒有正確的標記。

-或-

長度編碼在目前的編碼規則下無效。

-或-

內容在目前的編碼規則下無效。

-或-

編碼的值太大，無法放入 flagsEnumType 值中。

ArgumentException

flagsEnumType 不是列舉類型。

-或-

flagsEnumType 未使用 宣告 FlagsAttribute

-或-

expectedTag。TagClass是 Universal，但 expectedTagTagValue 對方法而言不正確。

ArgumentNullException

flagsEnumType 是 null

ReadNamedBitListValue<TFlagsEnum>(Nullable<Asn1Tag>)

來源:

AsnDecoder.NamedBitList.cs

讀取下一個值做為具有所指定標籤的 NamedBitList，同時將其轉換為 TFlagsEnum 所指定的 [FlagsAttribute] 列舉。

public TFlagsEnum ReadNamedBitListValue<TFlagsEnum> (System.Formats.Asn1.Asn1Tag? expectedTag = default) where TFlagsEnum : Enum;

member this.ReadNamedBitListValue : Nullable<System.Formats.Asn1.Asn1Tag> -> 'FlagsEnum (requires 'FlagsEnum :> Enum)

Public Function ReadNamedBitListValue(Of TFlagsEnum As Enum) (Optional expectedTag As Nullable(Of Asn1Tag) = Nothing) As TFlagsEnum

類型參數

TFlagsEnum

目的地列舉類型。

參數

expectedTag

Nullable<Asn1Tag>

要在讀取之前檢查的標籤。

傳回

TFlagsEnum

轉換成 TFlagsEnum 的 NamedBitList 值。

例外狀況

AsnContentException

下一個值沒有正確的標記。

-或-

長度編碼在目前的編碼規則下無效。

-或-

內容在目前的編碼規則下無效。

-或-

編碼的值太大，無法放入 TFlagsEnum 值中。

ArgumentException

TFlagsEnum 不是列舉類型。

-或-

TFlagsEnum 未使用 宣告 FlagsAttribute

-或-

expectedTag。TagClass是 Universal，但 expectedTagTagValue 對方法而言不正確。

備註

這個方法執行的位對齊方式是將值之第一個字節中的最有效位解譯為 中 TFlagsEnum最小有效位，而位會增加值，直到第一個字節的最小有效位為止，繼續處理第二個字節的最大有效位，依此類故。 在這裡設定下，下列 ASN.1 類型宣告和 C# 列舉可以一起使用：

KeyUsage ::= BIT STRING {
    digitalSignature        (0),
    nonRepudiation          (1),
    keyEncipherment         (2),
    dataEncipherment        (3),
    keyAgreement            (4),
    keyCertSign             (5),
    cRLSign                 (6),
    encipherOnly            (7),
    decipherOnly            (8) }

[Flags]
enum KeyUsage
{
    None = 0, DigitalSignature = 1 << (0),
    NonRepudiation = 1 << (1),
    KeyEncipherment = 1 << (2),
    DataEncipherment = 1 << (3),
    KeyAgreement = 1 << (4),
    KeyCertSign = 1 << (5),
    CrlSign = 1 << (6),
    EncipherOnly = 1 << (7),
    DecipherOnly = 1 << (8),
}

雖然這裡的範例使用 RFC 3280 中的 KeyUsage NamedBitList (4.2.1.3) ，但範例列舉會使用不同於 X509KeyUsageFlags的值。