Ektron CMS400.Net Reference

>>Managing Content > Displaying Content on your Web Site > XML Content Block

XML Content Block

Use an XML content block to display an XML content block on an Ektron CMS400.NET Web page.

Note: The following table only lists Ektron-specific properties. It does not describe native .NET properties such as font, height, width and border style. For documentation of these properties, see Visual Studio help.

Property

Value

Data Type

Authenticated

Indicates if you are logged in to the CMS Explorer and can use it to browse to Content, Collections, etc. See Also: Using CMS Explorer to Browse Your Ektron CMS400.NET Site

String

CacheInterval

Sets the amount of time, in seconds, a server control’s data is cached. The default is 0 (zero).

For example, if you want to cache the data for five minutes, set this property to 300. See Also: Caching with Server Controls

Double

DefaultContentID

The ID of a content block that appears where you inserted this server control if no other content block is identified, or is not available.

If you don’t know the ID number of the content block, use the CMS Explorer to browse to it. See Also: Using CMS Explorer to Browse Your Ektron CMS400.NET Site

Long

DisplayXslt

Specify an external XSLT file. See Also: The OverrideXslt and DisplayXslt Properties

Warning! If you specify an external file, it is strongly recommended that you do not store this file in your site's Workarea folder. If you store this file in the Workarea folder, the file will be lost when you upgrade.

String

 

DoInitFill

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 codebehind and have it render with your changes shown.

Boolean

DynamicParameter

To make this content block dynamic, select id. When you do, this server control uses the content block passed as a URL parameter.

String

Hide

Used to hide a content block in design time and run time.

True = Hide content block

False = Show content block

Boolean

Language

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

Integer

SuppressWrapperTags

Suppresses the output of the span/div tags around the control. The default is False.

True - Suppress wrap tags.

False - Allow wrap tags.

Boolean

WrapTag

Allows a developer to specify a server control’s tag.

The default is Span.

Span - The <span> tag is used to designate an in-line portion of an HTML document as a span element.

Div - The <div> tag is used when you want to apply attributes to a block of code.

Custom - Allows you to use a custom tag.

String

The OverrideXslt and DisplayXslt Properties

The DisplayXslt property is optional. If used, it specifies an external XSLT file. If the DisplayXslt property is not defined, the OverrideXslt property specifies an XSLT identified in the Edit Smart Form Configuration screen.

The following table provides more information about these properties.

To use this display XSLT

Enter this value for XSLT

Enter this value for Override XSLT

The default XSLT specified in the Edit Smart Form Configuration screen (illustrated below). Note that, in this example, the XSLT Packaged option is the default XSLT, since it is selected.

XSLT Packaged is the XSLT from the Edit Smart Form Configuration screen (that is, the XSLT created in the Data Designer).

 

Default

XSLT 1 from the Edit Smart Form Configuration screen

 

1

XSLT 2 from the Edit Smart Form Configuration screen

 

2

XSLT 3 from the Edit Smart Form Configuration screen

 

3

An absolute or relative path to an XSLT file.

An external XSLT file not specified in the Edit Smart Form Configuration screen.

For example:sample.xslt

Does not matter - if XSLT value exists, OverrideXSLT is ignored.

See Also: Working with Smart Formsl

Retrieving the XML Structure of an XML Content Block

Retrieving the XML structure of XML content allows for greater control over developing XSLs. The following is an example of how to retrieve the XML structure.

1. Open a new Web form.

2. Drag and drop a Content Block server control onto it.

3. Set the DefaultContentID to an XML content block.

Warning! This does not work with HTML content blocks, as there is no XML structure to output.

4. Drag and drop a Text box on the Web form.

5. Set the TextMode property to MultiLine.

Note: It is also recommended that you set the width of the text box to at least 400 px.

6. On the code behind page, add the following line.

TextBox1.Text = ContentBlock1.EkItem.Html

7. Build the project.

8. View the form in a browser.

9. The XML structure of the content block appears in the text box.

(continued in Using the ContentBlock Server Control Programmatically)


Visit the Ektron Dev Center at http://dev.ektron.com 1-866 - 4 - EKTRON

Ektron CMS400.NET Reference Version 8.02 SP1 Rev 1

Ektron Documentation,© 2011 Ektron, Inc.