Wprowadzenie do obiektu BuildManager

BuildManager Obiekt jest używany przez deweloperów innych firm, aby zarządzać plikami portable executable (PE).PE pliki są kompilowane z narzędzia niestandardowe, które wskazują w projekcie systemu, że ich dane wyjściowe są zestawiane do czasowego PE.

BuildManager Obiekt i narzędzia niestandardowe są używane w rozwoju wizualnych projektantów.Projektant w Visual Studio udostępnia graficzny interfejs użytkownika dla pliku.Aby utworzyć interfejs użytkownika, Projektant może być konieczne może utworzyć wystąpienia typów, opisanych w plikach elementu projektu.Tymczasowe pliki PE z narzędzia niestandardowe są pliki zestawu hermetyzujące rodzajów opisanych w elementy projektu, które są sygnałami wyjściowymi narzędzia niestandardowe.W ten sposób, projektanci i narzędzia niestandardowe często działają wspólnie do generowania interfejsu użytkownika w czasie projektowania.Dobrym przykładem jest narzędzie niestandardowe, który generuje klasy z pliku XSD.Wizualnych projektantów trzeba czasami wystąpienia klas generowanych w celu odnalezienia, co proffered za pomocą zestawu danych, aby zapewnić interfejsu użytkownika umożliwiające obsługę projektowania funkcje, takie jak wiązanie danych.

Narzędzia niestandardowe

Niestandardowe narzędzie przyjmuje jako dane wejściowe zawartość elementu projektu pliku i generuje nowego pliku element projektu, które mogą lub nie mogą być następnie kompilowane.Jest Typowa sekwencja zdarzeń:

1. Użytkownik lub projektant ustawia CustomTool właściwość elementu projektu.

2. Niestandardowe narzędzie jest uruchamiane z zawartością elementu projektu jako danych wejściowych.Jeśli niestandardowe narzędzie nie rozpoznaje dane wejściowe, błędy są zgłaszane do użytkownika, jak określić za pomocą narzędzia niestandardowe.Aby uzyskać więcej informacji, zobacz RunCustomTool.

3. Wraz z odwołania projektu danych wyjściowych narzędzia niestandardowe jest skompilowany w portable executable (PE czasowego).

   [!UWAGA]

   Dane wyjściowe tylko jest skompilowany w PE tymczasowe, jeśli niestandardowe narzędzie jest zarejestrowany z GeneratesDesignTimeOutput wartość rejestru jest ustawiona na wartość 1.

4. Opis PE jest dostępne, wywołując BuildManager obiektu BuildDesignTimeOutput metody.

   Tymczasowe dane wyjściowe PE zwracane przez BuildDesignTimeOutput jest w następujący sposób:

   <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>
   

Obiekt Obiekt BuildManager

BuildManager Obiektu zapewnia dostęp do czasowego PEs.DesignTimeOutputMonikers Właściwość jest tablicą wszystkich PE monikerów (nazwy) w projekcie.Project system przypisuje monikerów PE na podstawie hierarchii projektu.Na przykład, gdyby projektanta pliku XML SomeData.xsd w Folder1 z Project1 który wygenerował dane wyjściowe, SomeData.cs, następnie moniker byłoby Project1\Folder1\SomeData.cs.BuildDesignTimeOutput Metoda pobiera moniker jako parametr i zwraca opis PE w ciągu XML.

BuildManagerEventsClass Obiektu DesignTimeOutputDeleted zdarzenie jest wywoływane, gdy plik element projektu, który generuje PE jest usunięty z projektu.DesignTimeOutputDirty Zdarzenie jest wywoływane przy każdym uruchomieniu narzędzia niestandardowe (pojedynczy plik generator) generuje tymczasowe PE.Wszystkie generatory pojedynczy plik w programie project są uruchamiane, gdy:

• Projekt jest otwarty natychmiast po uaktualnieniu.

• Obszar nazw katalogu głównego uległ zmianie.

Generatory poszczególnych pojedynczy plik są uruchamiane, gdy:

• Dokument z generatora pojedynczy plik zostanie zapisany (na przykład, element dataset).

• Dokument z generatora pojedynczy plik jest otwarty i dirty, a użytkownik przechodzi do innego dokumentu w ramach Visual Studio.

• Plik w programie project z generatora pojedynczy plik jest zmieniona lub przeniesione.

• Użytkownik zmienił symbolicznie typ, który jest używany w pliku wyjściowym generatora pojedynczy plik.Na przykład jeśli użytkownik wywoła zmiany symboliczne nazwy typu "Typ" i że identyfikator typu używane w dataset1.vb (wyjście danych), generator pojedynczy plik pobiera wywoływane po zakończeniu operacji zmiany nazwy.

Kliknij łącze w poniższej tabeli pokaz programu za pomocą BuildManager obiektu.

Od innych dostawców

Wiele z BuildManager funkcjonalność obiektu również mogą uzyskać dostęp za pośrednictwem ITypeResolutionService interfejsu.Jednakże, należy użyć innych dostawców, które powinny być wyczerpujące Projektant DesignTimeOutputMonikers właściwości i BuildDesignTimeOutput metody.Aby uzyskać więcej informacji, zobacz Zakres automatyzacji w Visual Studio.