Office-projektek hibakeresése

Az Office-projektek hibakereséséhez ugyanazokat a Microsoft Visual Studio-eszközöket használhatja, amelyeket más Visual Studio-projektekhez is használ. Az Office-projektek hibakeresésekor a Visual Studio hibakereső funkciói, például töréspontok beszúrása és változók megtekintése a Helyiek ablakban is elérhetők. További információ a Visual Studio hibakeresési eszközeiről: Hibakeresés a Visual Studióban.

Jótanács

A hibakeresés egyszerűsítése érdekében zárja be az Office-alkalmazás nyitott példányait a létrehozás és a hibakeresés előtt.

A következőkre vonatkozik: A jelen témakör információi dokumentumszintű projektekre és VSTO-bővítményprojektekre vonatkoznak. Tekintse meg az Office-alkalmazás és a projekttípus által elérhető funkciókat.

Megjegyzés:

Szeretne olyan megoldásokat fejleszteni, amelyek több platformra is kiterjesztik az Office-élményt? Tekintse meg az új Office-bővítménymodellt. Az Office-bővítmények kis léptékűek a VSTO-bővítményekhez és -megoldásokhoz képest, és szinte bármilyen webes programozási technológia, például HTML5, JavaScript, CSS3 és XML használatával elkészíthetők.

A hibakereső indítása és leállítása

Az Office-projektek hibakeresését ugyanúgy kezdheti el, mint más Visual Studio-projektek hibakeresését; Például lenyomhatja az F5 billentyűt. A VSTO bővítményprojekt hibakeresésének megkezdésekor elindul a célzott Office-alkalmazás új folyamata, és betöltődik a VSTO-bővítmény.

Amikor elkezdi a dokumentumszintű projektek hibakeresését, a dokumentum vagy munkafüzet megnyílik egy új Word- vagy Excel-folyamatban.

Amikor leállítja a hibakeresőt, a hibakereső hirtelen leállítja az alkalmazásfolyamatot, vagy leválasztja, ha a hibakereső úgy van beállítva, hogy leválasszon. A leállított Office-alkalmazásfolyamatban megnyitott összes többi dokumentum figyelmeztetés nélkül is bezárul, és a nem mentett módosítások elvesznek. Ez magában foglalhatja az összes olyan dokumentumot vagy munkafüzetet, amely a hibakereső futtatása közben nyílik meg.

Általában jobb, ha a hibakereső leállítása előtt leválasztja a folyamatot, hogy a szokásos módon lépjen ki az Office-alkalmazásból. Ha a hibakereső leállítása után is egy megnyitott dokumentumot vagy munkalapot szeretne használni, először is leválaszthatja a folyamatról.

Ha dokumentumszintű testreszabást keres a Wordben, a hibakereső ismételt leállítása és a Word hirtelen bezárása a Normál sablon sérüléséhez vezethet. Ha ez történik, törölheti a sérült Normál sablont, és a rendszer automatikusan újra létrehozza a Word következő megnyitásakor. A Normál sablonban tárolt makrók azonban nem jönnek létre újra.

Office 2013 VSTO-bővítmények hibakeresése az Office 2013 vagy az Office 2016 használatával

Ha a Visual Studio 2015-öt használja, és az Office mindkét verziója egymás mellett van telepítve, a Visual Studio elindítja az Office 2016-ot. Ha Visual Studio 2013-at használ, a Visual Studio elindítja az Office 2013-at.

Ha az Office egy másik verziójával (2013 vagy 2016) szeretné hibakeresésre használni a VSTO-bővítményt, nyissa meg a Project Designert, és a Hibakeresés lapon válassza a Külső program indítása gombot. Ezután keresse meg a megfelelő végrehajtható Office-alkalmazás helyét.

F10 és F11 viselkedés

Az Office-projektek hibakeresésének megkezdésekor az F10 és az F11 nem ugyanazzal a működéssel rendelkezik, mint más Visual Basic- vagy C#-projektek hibakeresésekor. Visual Basic- vagy C#-projektekben a hibakereső leáll a fő függvényen; Az Office-projektekben a Visual Studio nem szabályozza az Office-alkalmazás fő funkcióját. A hibakeresés során azonban az F10 és az F11 ugyanazokkal a funkciókkal rendelkezik, mint a Visual Basic- és C#-projektekben.

Kivételek megjelenítése

Mivel a felügyelt kód nem felügyelt kódokkal működik együtt, a Visual Studio nem jeleníti meg a Microsoft Office-alkalmazások által generált hibákat. Ha például a Visual Studióban az Office fejlesztői eszközeivel létrehozott VSTO-bővítmény kivételt okoz, a Microsoft Office-alkalmazás hiba nélkül folytatódik. A hibák megtekintéséhez állítsa be a hibakeresőt a gyakori nyelvi futtatókörnyezeti kivételek megszakítására. További információ: Kivételek kezelése a hibakeresővel.

Ha a hibakeresőt úgy állítja be, hogy megszakítsa a közös nyelvi futtatókörnyezet kivételeit, minden kivétel meg fog szakadni a hibakeresőben, beleértve azokat is, amelyeket már kezeltek, valamint néhány első esélyes kivételt a saját futtatókörnyezetéből, amelyek lehet, hogy nem relevánsak a projekt szempontjából. Az msosec-ra hivatkozó hibák nem jelennek meg minden projektben, de nyugodtan figyelmen kívül hagyhatja őket. Ezek az msosec-kivételek nem érintik a megoldást.

A metódusaid köré Kipróbálás...Kivétel utasításokat is használhatsz a kivételek elkapására.

Alapértelmezés szerint a Visual Studio nem jeleníti meg a Just-In-Time hibakeresési hibákat az Office-projektekben; azonban engedélyezheti ezt a funkciót, hogy láthassa a felmerülő hibákat. További információ: Just-In-Time hibakeresés a Visual Studióban.

Parancssori paraméterek

Ha a HibakereséstulajdonságlapOn a Start Művelet a Projekt indítása beállításra van állítva, a Visual Studio nem használ parancssori argumentumokat a projekt hibakereséséhez, még akkor sem, ha parancssori argumentumokat adott meg indítási beállításként. Ha parancssori argumentumokat szeretne használni a hibakeresés indításakor, a Projekt indítása helyett a Start műveletet kell választania.

Forrásvezérlő

A hibakeresési tulajdonságokat a rendszer nem osztja meg több felhasználó között a forráskövetés alatt. A Visual Basic- és C#-projektek egy felhasználóspecifikus fájlban (ProjectName.vbproj.user vagy ProjectName.csproj.user) tárolják a hibakeresési tulajdonságokat, és ez a fájl nincs forráskontroll alatt. Ha egynél több személy hibakeresése történik, minden személynek manuálisan kell megadnia a hibakeresési tulajdonságokat.

Dokumentumszintű projekt esetén gyorsítótárazott adathalmazok hibajavítása

Minden alkalommal, amikor létrehoz egy projektet, az adathalmaz kiürítve és újra létrehozva lesz. Ha gyorsítótárazott adathalmazt szeretne hibakeresésre használni, nyissa meg a dokumentumot a Visual Studión kívül, majd csatolja a hibakeresőt.

Word-dokumentumprojektek hibakeresése a Word 97–2003-as dokumentumformátum (*.doc) alapján

Word-dokumentumprojekt Word 97–2003-as dokumentumformátumon (/.doc*) alapuló hibakereséséhez fel kell vennie a projektmappát a megbízható mappalistára. Ennek módjáról további információt a dokumentumok megbízhatóságának biztosítása című témakörben talál.

Letiltott bővítmények hibakeresése

A Microsoft Office-alkalmazások letilthatják a váratlanul viselkedő VSTO-bővítményeket. A Microsoft Office-alkalmazások letiltják a VSTO-bővítményeket, hogy megakadályozzák a problémás kód betöltését minden alkalommal, amikor az alkalmazás elindul. A tipikus hibakeresés során azonban könnyen okozhat váratlan viselkedést. A VSTO-bővítmények újbóli engedélyezésével kapcsolatos információkért tekintse meg a letiltott VSTO-bővítmények újbóli engedélyezését ismertető témakört.

A Microsoft Office alkalmazások kétféle módszert alkalmaznak a VSTO-bővítmények letiltására: a kemény letiltást és a puha letiltást.

Erőteljes letiltás

A végleges letiltás akkor fordulhat elő, ha egy VSTO-bővítmény miatt az alkalmazás váratlanul bezárul. Ez akkor is előfordulhat a fejlesztői számítógépen, ha leállítja a hibakeresőt, miközben a Startup VSTO-bővítmény eseménykezelője fut. Ha egy VSTO-bővítmény le van tiltva, az megjelenik az alkalmazás Letiltott elemek listájában.

Ha egy Office-alkalmazás szigorúan letiltja a Visual Studióban az Office fejlesztői eszközeivel létrehozott VSTO-bővítményt, az alkalmazás csak a hibát okozó VSTO-bővítményt tiltja le. Az adott Office-alkalmazáshoz tartozó, az Office fejlesztői eszközeivel a Visual Studio-ban létrehozott egyéb VSTO-bővítmények továbbra is betöltődnek.

Helyreállítható letiltás

A helyreállítható letiltás akkor fordulhat elő, ha egy VSTO-bővítmény olyan hibát okoz, amely nem okozza az alkalmazás váratlan bezárását. Előfordulhat például, hogy egy alkalmazás helyreállíthatóan letilt egy VSTO-bővítményt, ha nem kezelt kivételt jelez az Startup eseménykezelő végrehajtása közben. Ha egy VSTO-bővítmény helyreállíthatóan le van tiltva, az megjelenik az alkalmazás Inaktív alkalmazás bővítmények listájában, és az alkalmazás módosítja a VSTO-bővítmény LoadBehavior beállításjegyzék-bejegyzésének értékét, hogy jelezze, hogy ki van ürítve. A LoadBehavior beállításjegyzék-bejegyzésével kapcsolatos további információkért lásd a VSTO-bővítmények beállításjegyzék-bejegyzéseit.

Telepítési hibák elhárítása az Eseménynapló használatával

A Visual Studio Tools for Office futtatókörnyezet üzeneteket ír a Windows Eseménynaplóba az Office-megoldások telepítésekor vagy eltávolításakor megjelenő kivételekkel. Ezekkel az üzenetekkel megoldhatja a telepítési és üzembe helyezési problémákat.

Indítási hibák elhárítása naplófájl és hibaüzenetek használatával

Az Office-futtatókörnyezethez készült Visual Studio Tools képes az indítás során előforduló összes hibát naplófájlba írni, vagy az egyes hibákat megjeleníteni egy üzenetmezőben. Alapértelmezés szerint ezek a beállítások ki vannak kapcsolva. A beállításokat környezeti változók létrehozásával kapcsolhatja be.

Az egyes hibák üzenetmezőben való megjelenítéséhez hozzon létre egy környezeti változót, VSTO_SUPPRESSDISPLAYALERTS és állítsa 0 (nulla) értékre. Az üzeneteket letilthatja a környezeti változó törlésével vagy 1 (egy) értékre állításával.

Ha a hibákat egy naplófájlba szeretné írni, hozzon létre egy környezeti változót, VSTO_LOGALERTS és állítsa 1 (egy) értékre. Az Office-futtatókörnyezethez készült Visual Studio Tools létrehozza a naplófájlt abban a mappában, amely a VSTO-bővítmény üzembehelyezési jegyzékfájlját tartalmazza, vagy abban a mappában, amely a testreszabáshoz társított dokumentumot vagy munkafüzetet tartalmazza. Ha ez nem sikerül, a Visual Studio Tools for Office futtatókörnyezet létrehozza a naplófájlt a helyi %TEMP% mappában. Alkalmazásszintű VSTO-bővítmények esetén az alapértelmezett név a bővítmény neve.vsto.log. Dokumentumszintű projektek esetén a naplófájl neve dokumentumnév. bővítmény.log, például ExcelWorkbook1.xlsx.log. A naplózási hibák leállításához törölje a környezeti változót, vagy állítsa 0 (nulla) értékre.

Kapcsolódó tartalom

  • Last updated on