Placeholders

Content Management Server

Placeholders are areas in a template where authors can add content to each posting (page) that is based on that template. Microsoft Content Management Server (MCMS) 2002 implements placeholders in three parts.

  • Placeholder control: A Microsoft ASP.NET-based server control that provides the user interface for a placeholder in the Web Author

  • Placeholder definition: Defines the characteristics of the content in the placeholder

  • Placeholder object: A programmatic way to access the properties of a placeholder through the MCMS Publishing API

Placeholder Controls

A placeholder control is an ASP.NET-based server control that provides the user interface for a placeholder in both the authoring and presentation modes of the MCMS Web Author that content contributors use to create content.

You use the Toolbox window in Microsoft Visual Studio .NET to drag placeholder controls onto template files.

The three placeholder controls that are built in to MCMS are described in the following table.

Placeholder control Description

HtmlPlaceholderControl

Provides user interface for an HTML placeholder.

SingleAttachmentPlaceholderControl

Provides user interface for an attachment placeholder.

SingleImagePlaceholderControl

Provides user interface for an image.

You can create custom placeholder controls to create specialized user interfaces. For more information, see How to: Create Custom Placeholder Controls.

Placeholder Definitions

Placeholder definitions define the characteristics for a placeholder, such as constraints on the content. As a site developer, you can create custom placeholder definition classes to add constraints to the content, or to provide an API to access content in the placeholder.

Template designers use the Placeholder Definition Collection Editor in Visual Studio .NET to choose placeholder definitions for templates.

The following table shows the placeholder definitions that are built in to MCMS.

Placeholder definition type Description

HtmlPlaceholderDefinition

Controls configuration and constraint settings for an HTML placeholder. Use the properties of this placeholder definition to constrain the types of HTML formatting allowed in the placeholder. For more info see How to: Constrain HTML Tags for HTML Placeholders.

XmlPlaceholderDefinition

Controls configuration and constraint settings for an XML placeholder.

AttachmentPlaceholderDefinition

Controls configuration and constraint settings for an attachment placeholder.

ImagePlaceholderDefinition

Controls configuration and constraint settings for an image placeholder.

OfficeAttachmentPlaceholderDefinition

Controls configuration and constraint settings for an MCMS Authoring Connector attachment placeholder.

OfficeHtmlPlaceholderDefinition

Controls configuration and constraint settings for an MCMS Authoring Connector HTML placeholder.

You can create custom placeholder definitions to add custom constraints. You always partner placeholder definitions with placeholders. When you create a custom placeholder definition, you must also create a custom placeholder object. For more information, see Custom Placeholder Definition and Object Architecture.

Placeholder Objects

You use the Placeholder object in the MCMS Publishing API to access the properties of a placeholder programmatically.

You generally do not create custom placeholder objects; however, when you create a custom placeholder definition, you must also create a custom placeholder object. For more information see How to: Create Custom Placeholders and Placeholder Definitions.

See Also

Show: