AsnReader.ReadNamedBitListValue Método

Definição

Namespace:

System.Formats.Asn1

Assembly:

System.Formats.Asn1.dll

Sobrecargas

ReadNamedBitListValue(Type, Nullable<Asn1Tag>)	Lê o próximo valor como NamedBitList com uma marca especificada, convertendo-o para a enumeração [FlagsAttribute] especificada por flagsEnumType.
ReadNamedBitListValue<TFlagsEnum>(Nullable<Asn1Tag>)	Lê o próximo valor como NamedBitList com uma marca especificada, convertendo-o para a enumeração [FlagsAttribute] especificada por TFlagsEnum.

ReadNamedBitListValue(Type, Nullable<Asn1Tag>)

Origem:

AsnDecoder.NamedBitList.cs

Lê o próximo valor como NamedBitList com uma marca especificada, convertendo-o para a enumeração [FlagsAttribute] especificada por flagsEnumType.

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

Parâmetros

flagsEnumType

Type

Objeto type que representa o tipo de destino.

expectedTag

Nullable<Asn1Tag>

A marca a ser marcar antes da leitura.

Retornos

Enum

O valor de NamedBitList convertido em flagsEnumType.

Exceções

AsnContentException

O próximo valor não tem a marca correta.

-ou-

A codificação de comprimento não é válida de acordo com as regras de codificação atuais.

-ou-

O conteúdo não é válido de acordo com as regras de codificação atuais.

-ou-

O valor codificado é muito grande para caber em um flagsEnumType valor.

ArgumentException

flagsEnumType não é um tipo enumerado.

-ou-

flagsEnumType não foi declarado com FlagsAttribute

-ou-

expectedTag.TagClass é Universal, mas expectedTag.TagValue não está correto para o método .

ArgumentNullException

flagsEnumType é null

ReadNamedBitListValue<TFlagsEnum>(Nullable<Asn1Tag>)

Origem:

AsnDecoder.NamedBitList.cs

Lê o próximo valor como NamedBitList com uma marca especificada, convertendo-o para a enumeração [FlagsAttribute] especificada por TFlagsEnum.

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

Parâmetros de tipo

TFlagsEnum

Tipo de enumeração de destino.

Parâmetros

expectedTag

Nullable<Asn1Tag>

A marca a ser marcar antes da leitura.

Retornos

TFlagsEnum

O valor de NamedBitList convertido em TFlagsEnum.

Exceções

AsnContentException

O próximo valor não tem a marca correta.

-ou-

A codificação de comprimento não é válida de acordo com as regras de codificação atuais.

-ou-

O conteúdo não é válido de acordo com as regras de codificação atuais.

-ou-

O valor codificado é muito grande para caber em um TFlagsEnum valor.

ArgumentException

TFlagsEnum não é um tipo enumerado.

-ou-

TFlagsEnum não foi declarado com FlagsAttribute

-ou-

expectedTag.TagClass é Universal, mas expectedTag.TagValue não está correto para o método .

Comentários

O alinhamento de bits executado por esse método é interpretar o bit mais significativo no primeiro byte do valor como o bit menos significativo em TFlagsEnum, com bits aumentando em valor até o bit menos significativo do primeiro byte, continuando com o bit mais significativo do segundo byte e assim por diante. Nesse esquema, a seguinte declaração de tipo ASN.1 e a enumeração C# podem ser usadas juntas:

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

Embora o exemplo aqui use o KeyUsage NamedBitList do RFC 3280 (4.2.1.3), a enumeração de exemplo usa valores diferentes de X509KeyUsageFlags.