CborReader.ReadStartMap Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lê o próximo elemento de dados como o início de um mapa (tipo maior 5).
public:
Nullable<int> ReadStartMap();
public int? ReadStartMap();
member this.ReadStartMap : unit -> Nullable<int>
Public Function ReadStartMap () As Nullable(Of Integer)
Devoluções
O número de pares-chave-valor num 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 de curso correto.
O valor seguinte tem uma codificação CBOR inválida.
-ou-
Houve um fim inesperado dos dados de codificação CBOR.
-ou-
O valor seguinte utiliza uma codificação CBOR que não é válida no modo de conformidade atual.
Observações
O conteúdo do mapa é consumido como se fossem arrays com o dobro do tamanho declarado do mapa. Por exemplo, uma aplicação de tamanho 1 contendo uma chave de tipo Int32 com valor de tipo String deve ser consumida por chamadas sucessivas para ReadInt32() e ReadTextString(). Cabe ao chamador acompanhar se o próximo valor é uma chave ou um valor. Fundamentalmente, trata-se de uma restrição técnica derivada do facto de o CBOR permitir chaves de tipo arbitrário, por exemplo, um mapa pode conter chaves que são elas próprias mapas.