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

Source:

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

类型 对象，表示目标类型。

expectedTag

Nullable<Asn1Tag>

读取前要检查的标记。

返回

Enum

转换为 flagsEnumType 的 NamedBitList 值。

例外

AsnContentException

下一个值没有正确的标记。

-或-

长度编码在当前编码规则下无效。

-或-

在当前编码规则下，内容无效。

-或-

编码的值太大，无法容纳值 flagsEnumType 。

ArgumentException

flagsEnumType 不是枚举类型。

-或-

flagsEnumType 未使用 声明 FlagsAttribute

-或-

expectedTag。TagClass为 Universal，但 expectedTagTagValue 对于 方法，则不正确。

ArgumentNullException

flagsEnumType 为 null

ReadNamedBitListValue<TFlagsEnum>(Nullable<Asn1Tag>)

Source:

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 (4.2.1.3) 中的 KeyUsage NamedBitList，但示例枚举使用与 X509KeyUsageFlags不同的值。