AssetControl Server Control

The AssetControl server control, when viewed on a Web form, displays a drag and drop icon that lets you upload new assets or update an existing one. When you click this icon, a drag and drop box appears. This box is similar to the upload box in the Workarea. The difference between the Workarea and the server control is, in the Workarea users can only upload assets. With the AssetControl server control, you can upload a new asset or update an existing one by overwriting it. Even though the asset is overwritten, the previous version is still available through Ektron’s history feature. See Also: Managing Versions of Content.

The appearance of the AssetControl server control can vary depending on your browser. See Also: Methods for Importing Assets.

AssetControl server control properties

The following are Ektron-specific server control properties. You can find information about native .NET properties such as font, height, width and border style in Visual Studio® help.

  • Authenticated (String)

    Indicates if you are logged into the CMS Explorer and can use it to browse to content, collections, and so on. See Also: Browsing Your Ektron Site Using CMS Explorer.

  • DefaultAssetID (Long)

    The ID of the asset you want to update. This property is used when the UploadType property is set to Update. If you don’t know the ID number of the asset, use the CMS Explorer to browse to it. See Also: Browsing Your Ektron Site Using CMS Explorer

  • DefaultFolderID (Long)

    The ID of the folder where assets are added. This property is used when the UploadType property is set to Add. If you don’t know the ID number of the folder, use the CMS Explorer to browse to it. See Also: Browsing Your Ektron Site Using CMS Explorer

  • DoInitFill (Boolean)

    By default, Fill occurs during the Page_Init event. Set to false if you want to postpone the fill-action until later. In this case, Fill is automatically called during the Page Render event. You might do this if you need to set or change a property on the control in code-behind and have it render with your changes shown.

  • DynamicParameter (String)

    Gets or sets the QueryString parameter to read a content ID or folder ID dynamically. The content ID is read when the UploadType property is set to Update. The folder ID is read when UploadType property is set to Add. To use the default content ID or default folder ID, leave blank.

  • Hide (Boolean)

    Hides or displays the output of the control in design time and run time.

    • True—Hide the control output.
    • False—Display the control output.
  • IsImage (Integer)

    Setting this control to 1 (one) restricts the control so only images can be uploaded.

    • 1 (one)—restrict the control to uploading images only.
    • 0 (zero)—upload all types of assets.
  • Language (Integer)

    Set a language for viewing content; shows results in design-time (in Visual Studio) and at run-time (in a browser).

  • OverrideExtension (String)

    lets you restrict the type of asset that can be uploaded by its extension. For example, to restrict the control to uploading Word documents, enter doc in the property.

    WARNING! When using this property, enter only the extension’s letters not the wildcard (*) or the dot (.).

    You can add multiple extensions by creating a comma separated list of extensions. You should limit the list to 5 extensions.

  • SuppressWrapperTags (Boolean)

    Suppresses the output of the span/div tags around the control.

    • True—Suppress wrap tags.
    • False (default)—Allow wrap tags.
  • TaxonomyID (Long)

    The ID of the taxonomy with which to associate the asset.

  • UploadType (UploadTypeEnum)

    Select whether the control adds new assets or updates existing ones.

    • Add (default)—add assets and use the DefaultFolderID property. If a file of the same name already exists in the folder, the new file is created using the naming convention filename(2).
    • Update—update assets. In this case, you must identify an asset at the DefaultAssetID property.
  • WrapTag (String)

    Lets a developer specify a server control’s tag.

    • Span (default)—designate an inline portion of an HTML document as a span element.
    • Div—apply attributes to a block of code.
    • Custom—Lets you use a custom tag.