Setting Up an Add-In Solution

This Programming Tutorial shows you how to create a sample Windows Home Server add-in by using a Visual Studio solution.

This section walks through setting up both the Visual Studio solution and the Visual Studio project for the Console and Settings tabs.

Setting up Your Add-In Solution

When you create a new project in Visual Studio, you can create a Visual Studio solution at the same time to hold your project. Because you are creating an add-in that adds a tab to the Windows Home Server Console, you must create a .dll file. You create .dll files in Visual Studio by using a Windows Class Library project.

Creating the Class Library Project

In the following procedure, you create a Visual Studio class-library project and a Visual Studio Solution that contains the project.

To create a class library project in Visual Studio

1. With Visual Studio open, click File, point to New, and then click Project.

2. In New Project, in Project Types, expand the node for the programming language that you want to use to create your application, in this instance Visual C# or Visual Basic.

3. In Templates, click Class Library.

4. If you are using Visual Studio 2008, select .NET Framework 2.0 as your target Framework from the drop down list.

5. For the purposes of this walkthrough, name your project SDKSample.

6. Note that Solution Name is the same as the project name by default. The solution name can be different from the project name, but for the purpose of this tutorial, accept the default solution name, SDKSample.

7. Make sure that Create directory for solution is selected.

8. Confirm Name, Location, and Solution Name, and then click OK to close New Project and to create your new class-library project. A new Visual Studio solution is also created at the same time, and it contains your new class library project.

Setting the Properties of the Class Library Project

The Windows Home Server API requires that your .dll follow a specific naming convention. If you do not name your .dll as explained in the following section, your tab will not be loaded by the Windows Home Server Console.

Following Windows Home Server naming conventions for a .dll that extends the Windows Home Server Console

To ensure that the Windows Home Server Console recognizes and loads your tab, you must name your .dll file HomeServerConsoleTab.YourTabName.dll. You cannot change the first part of the file name, HomeServerConsoleTab. The second part of the .dll file name, YourTabName, can be any name that you choose and should not be a name that is used by any other tabs. In this way, your tab is distinguished from other tabs. For example, the Shared Folders tab in the Windows Home Server Console is implemented in the .dll file HomeServerConsoleTab.Sharing.dll.

To set the name of the .dll for the class-library project

1. In Visual Studio, right-click SDKSample in Solution Explorer, and then click Properties.

2. On the tab for SDKSample properties, click Application.

3. In Assembly Name, type HomeServerConsoleTab.SDKSample. Later, when you build your .dll, it will have the correct naming convention of HomeServerConsoleTab.YourTabName.dll. In this tutorial, Visual Studio outputs the SDKSample project to a .dll named HomeServerConsoleTab.SDKSample.dll.

4. On the main menu, click File, and then click Save All.

   Keep the properties tab open for the next procedure.

Adding Project Resources

The only project resource that you need for your class-library project is a bitmap image. The bitmap appears on your Console tab as well as on your Settings tab.

This tutorial uses an image file, SDKSample.png, but you can use any appropriate bitmap for your project. Add the bitmap image as follows.

To add the bitmap image to the resources for the class-library project

1. On the tab for SDKSample properties, click Resources.

2. If it appears, click the message This project does not contain a default resources file. Click here to create one.

3. Click the down arrow that is next to Add Resource, and then click Add Existing File.

4. Browse to the location of your bitmap image. Click the image file, and then click Open. A thumbnail of your image is added to the list of images resources for your project, with the name of the image file (without a file extension).

   Note

   You can change the name of the image file by renaming it in the Resources display pane. For example, rename SDKSample to SDKSampleImg to more easily recall what this resource is when it is referenced in code.

5. On the main menu, click File, and then click Save All.

6. Close the SDKSample properties tab.

Adding references to your class-library project

In order for your project to build correctly, make sure that you add the appropriate references. When you extend the Windows Home Server Console, you must reference the Microsoft.HomeServer.Extensibility namespace. The Microsoft.HomeServer.Extensibility namespace contains the API code that you use to create a new Console tab or Settings tab. The Microsoft.HomeServer.Extensibility namespace is contained in HomeServerExt.dll.

Because this tutorial demonstrates how to work with Windows Home Server objects besides Console tabs and Settings tabs, you also need to reference the Microsoft.HomeServer.SDK.Interop.v1 namespace, where all other Windows Home Server objects are defined. The Microsoft.HomeServer.SDK.Interop.v1 namespace is contained in Microsoft.HomeServer.SDK.Interop.v1.dll.

To add the appropriate references for the project, copy HomeServerExt.dll and Microsoft.HomeServer.SDK.Interop.v1.dll to your development computer, and then add a reference to them in your project's references.

To add references to HomeServerExt.dll and Microsoft.HomeServer.SDK.Interop.v1.dll

1. Copy HomeServerExt.dll and Microsoft.HomeServer.SDK.Interop.v1.dll from the %ProgramFiles%\Windows Home Server\ directory on the home server to a folder on your development computer, for example, "C:\HomeServerSDK."

2. In the Visual Studio Solution Explorer view, expand the SDKSample project.

3. If you are using C#, right-click References, and then click Add Reference. If you are using VB, right-click SDKSample, then click Add Reference.

4. On the Add Reference dialog, click the Browse tab, and then navigate to the location where you copied HomeServerExt.dll and Microsoft.HomeServer.SDK.Interop.v1.dll.

5. Select both files by holding down CTRL and clicking each file. Click OK to close Add Reference.

6. Repeat steps 1 through 3 for the System.Drawing and System.Windows.Forms namespaces, with the exception that these references are on the .NET tab.

7. HomeServerExt, Microsoft.HomeServer.SDK.Interop.v1, System.Drawing, and System.Windows.Forms appear in References in Solution Explorer(C#), or in References in the SDKSample properties tab (VB). Additionally, in the Visual Studio Object Browser window, the HomeServerExt and Microsoft.HomeServer.SDK.Interop.v1 nodes appear.

8. For the purposes of this walkthrough, rename the code file for your class to HomeServerTabExtender.cs (C#), or HomeServerTabExtender.vb (VB). To do so, right-click Class1.cs (C#), or Class1.vb (VB), in Solution Explorer. Click Rename on the popup menu. Rename the file to HomeServerTabExtender.cs (C#), or HomeServerTabExtender.vb (VB).

9. If a message appears asking if you want to rename all references to this class in your project, click Yes.

10. On the main menu, click File, and then click Save All.

Summary

The Visual Studio solution is set up and the properties for your class library project are configured. You are now ready to create the user interface and write the code for your Add-in using the Creating a Console Tab section of this tutorial.

See Also

Concepts

Creating a Settings Tab
Deploying an Add-In
Extending Windows Home Server