Recipe Property Handler Sample

Demonstrates the implementation of a property handler for custom format recipe (.recipe) files.

This topic contains the following sections.

• Description
• Requirements
• Downloading the Sample
• Building the Sample
• Running the Sample
• Removing the Sample
• Related topics

Description

This format supports several properties natively and also supports reading and writing arbitrary properties and custom schema. The sample also includes a custom property schema which defines properties that are germane to the .recipe file format (those not represented by any properties in the system's property schema).

Requirements

Downloading the Sample

This sample is available in the following locations.

In the case of the Windows SDK, once you have downloaded and installed it, you will find the samples in the installed directory. For example, use of the default installation path for the Windows 7 SDK results in the samples being placed under C:\Program Files\Microsoft SDKs\Windows\v7.0\Samples\.

Building the Sample

To build the sample from the command prompt:

1. Open the command prompt window and navigate to the RecipePropertyHandler project directory.
2. Enter msbuild RecipePropertyHandler.sln.

To build the sample using Microsoft Visual Studio (preferred):

1. Open Windows Explorer and navigate to the RecipePropertyHandler project directory.
2. Double-click the icon for the RecipePropertyHandler.sln file to open the project in Visual Studio.
3. From the Build menu, select Build Solution.

Running the Sample

1. Navigate to the directory that contains the DLL file, using the command prompt or Windows Explorer.
2. Type regsvr32.exe RecipePropertyHandler.dll
3. (Optional) Type prop.exe schema register RecipeProperties.propdesc to register the custom .recipe properties in the property schema.

   Note  The Prop.exe file can be obtained from http://www.codeplex.com/prop. The Property Schema Sample can also be used to register the schema.

Removing the Sample

1. Using the command prompt, navigate to the directory that contains the DLL file.
2. Type regsvr32.exe /u PropertyHandler.dll.
3. Type prop.exe schema unregister RecipeProperties.propdesc.
4. Delete the folder that contains the sample source files.

Related topics

Property System Code Samples

Ideal Property Handler Sample

Playlist Property Handler Sample

Property Edit Sample

Property Schema Sample

Send comments about this topic to Microsoft

Build date: 10/27/2012