ProjectItem element
Applies to: Visual Studio Visual Studio for Mac
Note
This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
Represents a SharePoint project item. This element the required root element of the .spdata file.
Syntax
<ProjectItem DefaultFile = "File that opens in the editor when you open the project item"
FeatureReceiverClass = "Class that implements a feature receiver for the project item"
FeatureReceiverAssembly = "Assembly that defines a feature receiver for the project item"
SupportedTrustLevels = "Trust levels that the project item supports"
SupportedDeploymentScopes = "Deployment scopes that the project item supports"
Type="Identifier for the project item">
<Files>...</Files>
<ProjectItemFolder>...</ProjectItemFolder>
<SafeControls>...</SafeControls>
<FeatureProperties>...</FeatureProperties>
<ExtensionData>...</ExtensionData>
</ProjectItem>
Attributes and elements
The following sections describe attributes, child elements, and parent elements.
Attributes
Attribute | Description |
---|---|
DefaultFile | Optional xs: string attribute. The relative path, including the file name, of the file that opens in the Visual Studio editor when you open the SharePoint project item in Solution Explorer. The path is relative from the folder that contains the .spdata file. |
FeatureReceiverClass | Optional xs:string attribute. The fully qualified name of a feature receiver class for this SharePoint project item. For more information about feature receivers, see Provide packaging and deployment information in project items. |
FeatureReceiverAssembly | Optional xs:string attribute. Specifies the fully qualified name of an assembly that defines a feature receiver for this SharePoint project item. For more information about feature receivers, see Provide packaging and deployment information in project items. For more information about fully qualified assembly names, see Assembly Names. |
SupportedTrustLevels | Optional xs:string attribute. Specifies the trust levels that this SharePoint project item supports. This value can be one of the following strings: Sandboxed, FullTrust, or All. The value All specifies both Sandboxed and FullTrust. In a custom SharePoint project item type, the value of this attribute corresponds to the value that you assign to the SupportedTrustLevels property in your implementation of the InitializeType method. If you specify a different value for this attribute, Visual Studio overwrites the value so that it specifies the same trust level that you specify in the SupportedTrustLevels property. |
SupportedDeploymentScopes | Optional xs:string attribute. Specifies the deployment scopes that this SharePoint project item supports. This value is a comma-delimited string that consists of one or more of the following strings: Farm, Site, Web, WebApplication, or Package. For example: Web, Site In a custom SharePoint project item type, the value of this attribute corresponds to the value that you assign to the SupportedDeploymentScopes property in your implementation of the InitializeType method. If you specify a different value for this attribute, Visual Studio overwrites the value so that it specifies the same trust level that you specify in the SupportedDeploymentScopes property. |
Type | Required xs:string attribute. The identifier for the SharePoint project item. In a custom SharePoint project item type, the identifier is the string that you pass to the SharePointProjectItemTypeAttribute. For more information, see How to: Define a SharePoint project item type. For a list of the identifiers for the built-in SharePoint project items included with Visual Studio, see Extend SharePoint project items. |
Child elements
Element | Description |
---|---|
ExtensionData | Optional element. Represents a collection of custom data items that are associated with the SharePoint project item. You can include only one ExtensionData element. |
FeatureProperties | Optional element. Represents a collection of property values that are included with a Feature when it is deployed to SharePoint. You can include only one FeatureProperties element. |
Files | Optional FileCollectionType element. Specifies the files to deploy with the SharePoint project item, such as Feature element files and the output of dependent non-SharePoint projects. Include either a Files or a ProjectItemFolder element, but not both. |
ProjectItemFolder | Optional ProjectItemFolderType element. Represents a mapped folder. Include either a Files or a ProjectItemFolder element, but not both. |
SafeControls | Optional element. Represents a collection of ASPX controls and Web Parts that are designated as secure for any user to access on any ASPX page on the SharePoint site. You can include only one SafeControls element. |
Parent elements
None.
Element information
Property | Value |
---|---|
Namespace | http://schemas.microsoft.com/VisualStudio/ 2010/SharePointTools/SharePointProjectItemModel |
Schema name | SharePoint Project Item Schema |
Validation file | ProjectItemModelSchema.xsd |
Can be empty | No |