CborReader.ReadStartMap Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membaca item data berikutnya sebagai awal peta (tipe utama 5).
public:
Nullable<int> ReadStartMap();
public int? ReadStartMap();
member this.ReadStartMap : unit -> Nullable<int>
Public Function ReadStartMap () As Nullable(Of Integer)
Mengembalikan
Jumlah pasangan kunci-nilai dalam peta panjang yang pasti, atau null jika peta panjangnya tidak terbatas.
Pengecualian
Item data berikutnya tidak memiliki tipe utama yang benar.
Nilai berikutnya memiliki pengodean CBOR yang tidak valid.
-atau-
Ada akhir data pengodean CBOR yang tidak terduga.
-atau-
Nilai berikutnya menggunakan pengodean CBOR yang tidak valid dalam mode kesesuaian saat ini.
Keterangan
Konten peta dikonsumsi seolah-olah merupakan array dua kali panjang ukuran peta yang dideklarasikan. Misalnya, peta ukuran 1 yang berisi kunci jenis Int32 dengan nilai jenis String harus dikonsumsi oleh panggilan berturut-turut ke ReadInt32() dan ReadTextString(). Terserah pemanggil untuk melacak apakah nilai berikutnya adalah kunci atau nilai. Pada dasarnya, ini adalah pembatasan teknis yang berasal dari fakta bahwa CBOR memungkinkan kunci jenis arbitrer, misalnya peta dapat berisi kunci yang memetakan sendiri.