CborReader.ReadStartMap Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Lê o item de dados seguinte como o início de um mapa (tipo principal 5).
public:
Nullable<int> ReadStartMap();public int? ReadStartMap ();member this.ReadStartMap : unit -> Nullable<int>Public Function ReadStartMap () As Nullable(Of Integer)Retornos
O número de pares chave-valor em um mapa de comprimento definido ou null se o mapa tiver comprimento indefinido.
Exceções
O item de dados seguinte não tem o tipo principal correto.
O próximo valor tem uma codificação CBOR inválida.
- ou -
Houve um fim inesperado dos dados de codificação CBOR.
- ou -
O valor seguinte usa uma codificação CBOR que não é válida no modo de conformidade atual.
Comentários
O conteúdo do mapa é consumido como se fossem matrizes duas vezes o comprimento do tamanho declarado do mapa. Por exemplo, um mapa de tamanho 1 que contém uma chave do tipo Int32 com um valor do tipo String deve ser consumido por chamadas sucessivas para ReadInt32() e ReadTextString(). Cabe ao chamador controlar se o próximo valor é uma chave ou um valor. Fundamentalmente, essa é uma restrição técnica decorrente do fato de que o CBOR permite chaves de tipo arbitrário, por exemplo, um mapa pode conter chaves que são mapas em si.
