Walkthrough: Installing an Event Log Component

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

The procedures on this page walk you through the process of setting up an installation component for an instance of the EventLog component, including creating the component instance, adding an installer for it, and compiling and running the installer.

Note Note

Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Working with Settings.

To create your EventLog component

  1. On the File menu, point to New, and then click Project.

  2. In the New Project dialog box, create a Visual Basic or Visual C# Windows Application. Name the project MyEventLog.

  3. From the Components tab of the Toolbox, drag an EventLog component to the form.

  4. In the Properties window, set the following values:

    • Set the Log() property to Application.

    • Set the MachineName() property to the name of the server on which the event log resides. Use a period (.) for the local computer.

    • Set the Source() property to the string of your choice. In this case, you can use the name of your project.

  5. Save your files.

    Note Note

    For more information on creating EventLog component instances and setting their properties, see Logging Application, Server, and Security Events.

To create an installation component for your EventLog component

  1. In the designer, click the EventLog1 component.

  2. With the designer in focus, right-click, and then click Add Installer.

    An Installer class appears in your project, and an installation component is added to it.

    You can now install and run your application.

To build your installation

  • Save your project and build it.

    Note Note

    Because this installer will function correctly without changing the existing methods, you do not need to override the Install(IDictionary), Commit(IDictionary), Rollback(IDictionary), and Uninstall(IDictionary) methods.

    A setup project installs the compiled project files and runs the installers needed to run a Windows application.

To create a setup project for your application

  1. On the File menu, point to Add Project, then click New Project.

  2. In the Project Types pane, select the Setup and Deployment Projects folder.

  3. In the Templates pane, select Setup Project. Name the project MyEventLogSetup.

    A setup project is added to the solution.

Next, you will add the output from the Windows Application project to the setup.

To add the project output to the setup

  1. In Solution Explorer, right-click MyEventLogSetup, point to Add, then choose Project Output.

    The Add Project Output Group dialog box appears.

  2. MyEventLog is selected in the Project box.

  3. In the list box, select Primary Output, then click OK.

    A project item for the primary output of MyEventLog is added to the setup project.

    Now add a custom action to install the MyNewService.exe file.

To add a custom action to the setup

  1. In Solution Explorer, right-click the setup project, point to View, then choose Custom Actions.

    The Custom Actions editor appears.

  2. In the Custom Actions editor, right-click the Custom Actions node and choose Add Custom Action.

    The Select Item in Project dialog box appears.

  3. Double-click the Application Folder in the list box to open it, select Primary Output from MyEventLog (Active), and click OK.

    The primary output is added to all four nodes of the custom actions, Install, Commit, Rollback, and Uninstall.

  4. Build the setup project.

  5. To install MyEventLog.exe, right-click the setup project in the Solution Explorer and select Install.

Community Additions