Szimbólumok

  • Cikk

A szimbólumok a hibakereséshez és más diagnosztikai eszközökhöz hasznosak. A szimbólumfájlok tartalma nyelvektől, fordítóktól és platformoktól függően változik. Magas szinten a szimbólumok a forráskód és a fordító által előállított bináris kód közötti leképezések. Ezeket a leképezéseket olyan eszközök használják, mint a Visual Studio és a Visual Studio Code a forrássorok számadatainak vagy a helyi változóneveknek a feloldásához.

A Windows szimbólumokkal kapcsolatos dokumentációja részletesebb információkat tartalmaz a Windows szimbólumokról, bár számos fogalom más platformokra is vonatkozik.

További információ. A NET hordozható PDB formátuma

A .NET Core bevezetett egy új szimbólumfájlt (PDB) – a hordozható PDB-t. A hagyományos, csak Windows rendszerű PDF-ekkel ellentétben a hordozható PDF-ek minden platformon létrehozhatók és olvashatók.

Mi az a PDB?

A PDB-fájl egy fordító által létrehozott kiegészítő fájl, amely más eszközöket, különösen hibakeresőket, információkat biztosít a fő végrehajtható fájlban található adatokról és azok előállításának módjáról. Egy hibakereső például beolvassa a PDF-fájlt foo.cs 12. sor megfelelő végrehajtható helyre való leképezéséhez, hogy töréspontot állítson be. A Windows PDB formátum már régóta működik, és más natív hibakeresési szimbólumformátumokból alakult ki, amelyek még régebbiek voltak. A natív (C/C++) programok formátumaként kezdte meg az életét. A .NET-keretrendszer első kiadásához a Windows PDB formátum ki lett terjesztve a .NET támogatásához.

A hordozható PDF-formátum a .NET Core-ban lett bevezetve, és alapértelmezés szerint a .NET-et célozza meg. A .NET-keretrendszer megcélzásakor a projektfájlban megadott <DebugType>portable</DebugType> módon engedélyezheti a hordozható PDB-szimbólumokat. A hordozható PDB formátum az ECMA-335 metaadat-formátumon alapul. További információ: Portable PDB v1.0: Format Specification. A diagnosztikai eszközök a System.Reflection.Metadata tár használatával hordozható PDF-fájlokat olvashatnak (például lásd System.Reflection.Metadata.Document: ).

A forgatókönyvhöz megfelelő PDB-formátum használata

Sem a hordozható PDF-fájlok, sem a Windows PDF-ek nem támogatottak mindenhol. A használni kívánt formátum kiválasztásához fontolja meg a projekt használatát és hibakeresését. Ha olyan projektje van, amelyet mindkét formátumban szeretne használni és hibakeresésre használni, különböző buildkonfigurációkat használhat, és kétszer is létrehozhatja a projektet mindkét fogyasztótípus támogatásához.

Hordozható PDF-ek támogatása

A hordozható PDF-fájlok bármilyen operációs rendszeren olvashatók, és a felügyelt kód ajánlott szimbólumformátuma. Számos régi eszköz és alkalmazás azonban nem támogatott:

  • A 4.7.1-es vagy korábbi .NET-keretrendszer célalkalmazások: a verem nyomait a sorszámokra való leképezésekkel (például egy ASP.NET hibaoldalon) nyomtathatja. A metódusok neve nem változik, csak a forrásfájlnevek és a sorszámok nem támogatottak.

  • Ha .NET-dekompilátorokat, például ildasmot vagy .NET-reflektort használ, a forrásvonal-leképezések és a helyi paraméternevek nem fognak megjelenni.

  • A DIA legújabb verziói és a dia szimbólumok olvasására szolgáló eszközök( például a WinDBG) támogatják a hordozható PDF-eket, a régebbi verziók azonban nem.

  • Előfordulhat, hogy a profilkészítők régebbi verziói nem támogatják a hordozható PDF-eket.

Ha hordozható PDF-eket szeretne használni olyan eszközökre, amelyek nem támogatják őket, használhatja a Pdb2Pdb-t, amely hordozható PDF-ek és Windows-PDF-ek között konvertál.

WindowsOS PDF-ek támogatása

A Windows PDF-eket csak Windows rendszeren lehet írni vagy olvasni. A Windows PDF-fájlok felügyelt kódhoz való használata elavult, és csak az örökölt eszközökhöz szükséges. Javasoljuk, hogy windowsos PDF-ek helyett hordozható PDF-eket használjon, mivel egyes újabb fordítófunkciók csak hordozható PDF-ekhez vannak implementálva.

Lásd még