customProperties (External Application)

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

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