Sdílet prostřednictvím

Postupy: Podmíněná kompilace pomocí atributu Trace a Debug

Poznámka:

Tento článek je specifický pro rozhraní .NET Framework. Nevztahuje se na novější implementace .NET, včetně .NET 6 a novějších verzí.

Při ladění aplikace během vývoje přejde výstup trasování i ladění do okna Výstup v sadě Visual Studio. Pokud ale chcete do nasazené aplikace zahrnout funkce trasování, musíte zkompilovat instrumentované aplikace s povolenou direktivou kompilátoru TRACE . To umožňuje kompilaci trasovacího kódu do verze vaší aplikace. Pokud direktivu TRACE nepovolíte, veškerý kód trasování se během kompilace ignoruje a není součástí spustitelného kódu, který nasadíte.

Metody trasování i ladění mají přidružené podmíněné atributy. Pokud je například podmíněný atribut pro trasování pravdivý, jsou všechny příkazy trasování zahrnuty do sestavení (zkompilovaný soubor .exe nebo .dll); pokud je podmíněný atribut Trace false, nebudou zahrnuty příkazy trasování.

Pro sestavení můžete mít zapnutý podmíněný atribut Trasování nebo Ladění , nebo obojí nebo ani jeden. Existují tedy čtyři typy sestavení: Ladění, Trasování, obojí nebo ani jedno. Některé buildy vydaných verzí pro produkční nasazení nemusí obsahovat ani jedno; většina sestavení ladění obsahuje obojí.

Nastavení kompilátoru pro vaši aplikaci můžete zadat několika způsoby:

  • Stránky vlastností

  • Příkazový řádek

  • #CONST (pro Visual Basic) a #define (pro C#)

Změna nastavení kompilace z dialogového okna stránek vlastností

  1. Klikněte pravým tlačítkem myši na uzel projektu v Průzkumník řešení.

  2. V místní nabídce zvolte Vlastnosti .

    • V jazyce Visual Basic klepněte na kartu Kompilace v levém podokně stránky vlastností a potom klepněte na tlačítko Upřesnit možnosti kompilace zobrazte dialogové okno Upřesnit nastavení kompilátoru. Zaškrtněte políčka pro nastavení kompilátoru, která chcete povolit. Zrušte zaškrtnutí políček u nastavení, která chcete zakázat.

    • V jazyce C# klikněte na kartu Sestavení v levém podokně stránky vlastností a potom zaškrtněte políčka pro nastavení kompilátoru, která chcete povolit. Zrušte zaškrtnutí políček u nastavení, která chcete zakázat.

Kompilace instrumentovaného kódu pomocí příkazového řádku

  1. Nastavte přepínač podmíněného kompilátoru na příkazovém řádku. Kompilátor bude obsahovat trasovací nebo ladicí kód ve spustitelném souboru.

    Například následující instrukce kompilátoru zadaná na příkazovém řádku by obsahovala kód trasování do zkompilovaného spustitelného souboru:

    Pro Visual Basic: vbc -r:System.dll -d:TRACE=TRUE -d:DEBUG=FALSE MyApplication.vb

    Pro C#: csc -r:System.dll -d:TRACE -d:DEBUG=FALSE MyApplication.cs

    Tip

    Pokud chcete zkompilovat více než jeden soubor aplikace, nechte mezi názvy souborů prázdné místo, například MyApplication1.vb MyApplication2.vb MyApplication3.vb nebo MyApplication1.cs MyApplication2.cs MyApplication3.cs.

    Význam direktiv podmíněné kompilace použité v předchozích příkladech je následující:

    Direktiva Význam
    vbc Visual Basic – kompilátor
    csc Kompilátor C#
    -r: Odkazuje na externí sestavení (EXE nebo DLL)
    -d: Definuje symbol podmíněné kompilace.

    Poznámka:

    Příkaz TRACE nebo DEBUG musíte zapsat velkými písmeny. Další informace o příkazech podmíněné kompilace potřebujete zadat vbc /? (pro Visual Basic) nebo csc /? (pro jazyk C#) na příkazovém řádku. Další informace najdete v tématu Sestavení z příkazového řádku (C#) nebo vyvolání kompilátoru příkazového řádku (Visual Basic).

Provedení podmíněné kompilace pomocí #CONST nebo #define

  1. Do horní části souboru zdrojového kódu zadejte odpovídající příkaz pro váš programovací jazyk.

    Jazyk Příkaz Výsledek
    Visual Basic #CONST TRACE = true Povolí trasování.
    #CONST TRACE = false Zakáže trasování.
    #CONST DEBUG = true Povolí ladění.
    #CONST DEBUG = false Zakáže ladění.
    C# trasování #define Povolí trasování.
    trasování #undef Zakáže trasování.
    ladění #define Povolí ladění.
    ladění #undef Zakáže ladění.

Zakázání trasování nebo ladění

Odstraňte direktivu kompilátoru ze zdrojového kódu.

- nebo -

Zakomentujte direktivu kompilátoru.

Poznámka:

Až budete připravení zkompilovat, můžete buď zvolit sestavení z nabídky Sestavení, nebo použít metodu příkazového řádku, ale bez zadání d: definovat symboly podmíněné kompilace.

Viz také

  • Last updated on