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 próximo item de dados 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 for de comprimento indefinido.
Exceções
O próximo item de dados 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 próximo valor 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 o dobro do tamanho declarado do mapa. Por exemplo, um mapa do tamanho 1 que contém uma chave de tipo Int32 com um valor de tipo String deve ser consumido por chamadas sucessivas para ReadInt32() .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 os próprios mapas.