customProperties (External Application)

Article
10/20/2016

Applies to: SharePoint Foundation 2010

Provides custom information about the external application or the Web Part.

applicationParts (External Application)
  applicationPart (External Application)
    data (External Application)
      customProperties (External Application)

<customProperties> ... </customProperties>

Complex

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Any XML markup can be the child of <customProperties>. Typically, it would contain <property> elements with the same syntax as those used in the <webPartProperties> element.

Parent Elements

Element	Description
data	Provides information about the presentation of the Web Part and possibly also custom information about the external application and the Web Part.

Remarks

The <customProperties> element is optional. It is not used by the default External Application Provider (EAP). However, it could be used by a custom EAP. For example, if the custom EAP includes a custom registration page for external applications, the code behind that page could be used to create an application principal user. The <customProperties> element could be used to store the permissions that the application principal should have.

Contrast the use of this element with the SilverlightWebPart.CustomInitParameters and the SilverlightWebPart.CustomProperties properties. Each of the three has a different purpose.

Example

The following markup shows this element in use.

<?xml version='1.0' encoding='utf-16'?>
<applicationParts xmlns='https://schemas.microsoft.com/sharepoint/2009/fluidapp'>
  <applicationPart>
    <metaData>
      <applicationId>00000000-0000-0000-0000-000000000000</applicationId>
      <applicationUrl>https://www.contoso.com/someapplication.xap</applicationUrl>
      <principal>domain\username</principal>
      <sharepointRequestHandlerUrl>/sp.ashx</sharepointRequestHandlerUrl>
    </metaData>
    <data>
      <webPartProperties>
        <property name='Title'>Title</property>
        <property name='Description'>Description</property>
        <property name='WindowlessMode'>TRUE</property>
        <property name='Height'>200px</property>
        <property name='Width'>100px</property>
        <property name='HelpUrl'>https://www.contoso.com/someapplication/help.aspx</property>
        <property name='HelpMode'>Modal</property>
        <property name='Direction'>NotSet</property>
        <property name='MinRuntimeVersion'>3.0</property>
      </webPartProperties>
      <customProperties>
        <property name='CustomPropertyName'>CustomPropertyInfo</property>
      </customProperties>
    </data>
  </applicationPart>
</applicationParts>

Element Information

Namespace	https://schemas.microsoft.com/sharepoint/2009/fluidapp
Schema Name	FluidAppSettings
Validation File	Drive:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\XML\FluidApplicationSettings.xsd
Can be Empty	No

Share via