CborReader.ReadStartMap Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Lit l’élément de données suivant comme début d’une carte (type principal 5).
public:
Nullable<int> ReadStartMap();
public int? ReadStartMap();
member this.ReadStartMap : unit -> Nullable<int>
Public Function ReadStartMap () As Nullable(Of Integer)
Retours
Nombre de paires clé-valeur dans une carte de longueur définie ou null si la carte est de longueur indéfinie.
Exceptions
L’élément de données suivant n’a pas le type principal correct.
La valeur suivante a un encodage CBOR non valide.
- ou -
Il y avait une fin inattendue des données d’encodage CBOR.
- ou -
La valeur suivante utilise un encodage CBOR qui n’est pas valide en mode de conformité actuel.
Remarques
Le contenu de la carte est consommé comme s’il s’agissait de tableaux deux fois la longueur de la taille déclarée de la carte. Par exemple, une carte de taille 1 contenant une clé de type Int32 avec une valeur de type String doit être consommée par des appels successifs vers ReadInt32() et ReadTextString(). Il incombe à l’appelant de suivre si la valeur suivante est une clé ou une valeur. Fondamentalement, il s’agit d’une restriction technique résultant du fait que CBOR autorise les clés de type arbitraire, par exemple une carte peut contenir des clés qui sont des cartes elles-mêmes.