The application manifest describes a Silverlight™ application to the Silverlight Streaming hosting service. The manifest is an XML file that specifies the values used to create an instance of your Silverlight application on the Silverlight Streaming server.
You can create and edit the application manifest in either of the following ways:
-
By using the Silverlight Streaming administration site.
-
By creating the manifest file and including it in the application package.
To use the administration site to edit the manifest, see Configuring the Application.
If you create the manifest file yourself, it must be named manifest.xml, and it must be included in the application package when you upload the package to Silverlight Streaming via the administration site. If it is absent from the package, the administration site will not upload the package.
.gif) Note: |
|---|
|
If you are using the Silverlight 2 Beta and the Silverlight Tools Beta for Visual Studio, the manifest file is automatically created for you and included in the .xap package that is generated when you build the project.
|
Manifest Elements
Several of the elements defined in the manifest correspond to the parameters defined by the Silverlight.createObject() method. This method is employed by Silverlight applications to create an instance of the Silverlight runtime. You should move the values supplied for these parameters into the manifest when you migrate your Silverlight application to Silverlight Streaming.
The general schema for the manifest is shown in the following example.
<SilverlightApp>
<source>XAML or XAP file</source>
<version>1.0 | 2.0</version>
<width>[value in browser units or percentage]</width>
<height>[value in browser units or percentage]</height>
<jsOrder>
<js>[js file to load first]</js>
<js>[js file to load second]</js>
<js>...</js>
</jsOrder>
</SilverlightApp>
The list of possible child elements for the manifest is shown in the table below. All values are strings.
|
Element
|
Description
|
| source | The filename of the main XAML file or the application's XAP file, relative to the directory structure of the ZIP file. |
| version | The minimum version of the Silverlight runtime required to run your Silverlight application. For example, if you set the value of this element to 1.0, the user must have version 1.0 or greater of the Silverlight runtime to view it. If you leave this value blank, the user will be forced to download the latest Silverlight runtime to run your application. |
| width | The width of the Silverlight application, expressed in browser units (pixels) or as a percentage value. |
| height | The height of the Silverlight application, expressed in browser units (pixels) or as a percentage value. |
| background | A string value specifying the background color for the application frame after the application has loaded and while it is initializing. It may be a named color value or an 8-bit or 16-bit color value, with or without alpha transparency. |
| backgroundImage | A string value specifying a background image for the application frame after the application has loaded and while it is initializing. |
| isWindowless | Specifies whether to display the Silverlight control in windowless mode. True or False. |
| framerate | The maximum number of frames to render per second. |
| enableHtmlAccess | Specifies whether the hosted content in the Silverlight control has access to the browser Document Object Model (DOM). True or False. |
| inPlaceInstallPrompt | Determines whether to display an install prompt if the detected version of Silverlight is out of date. |
| onLoad | The name of a JavaScript function to run when the application has finished loading and the content has rendered. Note that this functionality differs from that of the Silverlight onLoad event, which fires after the application has finished loading but before the content has rendered. |
| onError | The name of a JavaScript error handling function. |
| jsOrder | Specifies the order in which JavaScript files will be loaded. Each file should be listed with the relative path name as it appears in the ZIP file. File names and paths are case-sensitive. Any JavaScript files not mentioned will be loaded in an unspecified order after the listed files. |
See Also