Představení objektu BuildManager

  • Článek

BuildManager Správa souborů přenosné spustitelný soubor (PE) používají vývojáři třetích stran objektu.Z vlastní nástroje, které označují projektu jsou kompilovány soubory PE systém, který je jejich výstup do dočasné PE sestavují.

BuildManager Objektu a vlastní nástroje se používají v rozvoji vizuální návrháře.Návrhář v Visual Studio poskytuje grafické uživatelské rozhraní pro soubor.Chcete-li vytvořit uživatelské rozhraní, Návrhář potřeba moci vytvořit instanci typy souborů položky projektu.Dočasné soubory PE z vlastní nástroje jsou soubory sestavení, které zapouzdřit typy podle položky projektu, které jsou výstupy vlastní nástroj.Tedy vlastní nástroje a návrháři často společně generování návrhu uživatelského rozhraní.Dobrým příkladem tohoto je vlastní nástroj, který generuje tříd ze souboru XSD.Návrháři Visual třeba někdy konkretizovat generované třídy s cílem zjistit, co je proffered přes sadu dat s cílem poskytnout uživatelského rozhraní pro povolení podpory návrhu pro funkce, jako jsou například datové vazby.

Vlastní nástroje

Vlastní nástroj trvá jako vstupní obsah položky projektu souboru a vytvoří novou položku soubor projektu, který může nebo mohou být následně zkompilované.Je typická posloupnost událostí:

  1. Uživatel nebo Návrhář nastaví CustomTool vlastností položky projektu.

  2. Vlastní nástroj obsah položky projektu pracovat jako vstup.Pokud vlastní nástroj nerozpozná vstup, chyby jsou hlášeny uživateli se stanoví vlastní nástroj.Další informace naleznete v tématu RunCustomTool.

  3. Spolu s odkazy projektu vlastní nástroj výstup zkompilován přenosné spustitelný soubor (dočasné PE).

    [!POZNÁMKA]

    Výstup pouze kompilován do dočasné PE, pokud vlastní nástroj zaregistrován GeneratesDesignTimeOutput hodnota registru nastavena na 1.

  4. Popis prostředí PE je k dispozici voláním BuildManager objektu BuildDesignTimeOutput metoda.

    Dočasná výstupní PE vrácené BuildDesignTimeOutput je následující:

    <root>
    <Application private_binpath="full output path to temporary PE,
excluding the name"/>
    <Assembly
        codebase = "filename of the temporary PE, e.g., sample.dll""
        name = "name of the temporary PE == filename without the 
extension, e.g., "sample""
        version = "always "0.0.0.0""
        snapshot_id = "unique ID number" 
        replaceable = "currently unused; always set to "True""
    />
</root>

Objekt Správce BuildManager

BuildManager Objektu poskytuje přístup k dočasné PEs.DesignTimeOutputMonikers Vlastnost je pole zástupných všechny PE názvů (jména) v projektu.PE zástupných názvů na základě hierarchie projektu přiřadí systém projektu.Například, kdyby umělecký soubor XML, SomeData.xsd v složka1 z Project1, který vygeneroval výstupní SomeData.cs, potom zástupný název by Project1\Folder1\SomeData.cs.BuildDesignTimeOutput Metoda přebírá zástupný název jako parametr a vrátí řetězec XML popis prostředí PE.

BuildManagerEventsClass Objektu DesignTimeOutputDeleted událost je aktivována, když položku soubor projektu, který generuje PE je odstraněn z projektu.DesignTimeOutputDirty Událost je aktivována při každém spuštění vlastní nástroj (jeden soubor generátor), který generuje dočasné PE.Všechny generátory jednoho souboru v projektu při spuštění:

  • Projekt je otevřen bezprostředně po inovaci.

  • Kořenový obor názvů byl změněn.

Generátory jednotlivých jeden soubor při spuštění:

  • Uložení dokumentu se generátor jediný soubor (například objekt dataset).

  • Dokument s jedním souborem generátoru je otevřít a dirty a přepnutí do jiného dokumentu v rámci Visual Studio.

  • Soubor projektu s jedním souborem generátoru je přejmenována nebo přesunuta.

  • Uživatel symbolicky přejmenoval typ, který se používá v rámci výstupní soubor generátor jeden soubor.Například pokud uživatel vyvolá symbolické přejmenovat na "typ" a že id typu použitých v dataset1.vb (výstup objektu dataset) jeden soubor generátor získá vyvolat po dokončení operace přejmenování.

Klepněte na odkaz v tabulce na ukázku, jak program pomocí BuildManager objektu.

Akce

Odkaz

Zobrazení zástupných názvů pro dočasné soubory PE a sledování BuildManagerEvents.

Postupy: Používání objektů BuildManager a BuildManagerEvents

Jiných dodavatelů

Velká část BuildManager funkčnost objektu je také přístupný prostřednictvím ITypeResolutionService rozhraní.Však musí používat jiných dodavatelů, které mají komplexní designer DesignTimeOutputMonikers vlastnosti a BuildDesignTimeOutput metoda.Další informace naleznete v tématu Spektrum automatizace sady Visual Studio.