TemplateContainerAttribute.BindingDirection Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets the binding direction of the container control.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public BindingDirection BindingDirection { get; }

Property Value

Type: System.ComponentModel.BindingDirection

A BindingDirection indicating the container control's binding direction. The default is OneWay.

The BindingDirection property can be either the OneWay field, where the template can accept only property values or the TwoWay field, where the template can accept and expose property values. In the latter scenario, data-bound controls automatically can use the update, delete, and insert operations of a data source using the Bind data-binding syntax.

For more information on data binding, see Binding to Databases and Data-Binding Expressions Overview.

The following code example demonstrates how to create a templated control named TemplatedFirstControl and associate it with a container named FirstTemplateContainer. This allows the creation of custom controls that display the server time when the template is not specified and the contents of the template when the template is specified. The GetCustomAttribute method determines the BindingDirection property of the FirstTemplate property of the TemplateFirstControl.

This code example is part of a larger example provided for the TemplateContainerAttribute class.

// Get the class type for which to access metadata.
Type clsType = typeof(TemplatedFirstControl);
// Get the PropertyInfo object for FirstTemplate.
PropertyInfo pInfo = clsType.GetProperty("FirstTemplate");
// See if the TemplateContainer attribute is defined for this property.
bool isDef = Attribute.IsDefined(pInfo, typeof(TemplateContainerAttribute));
// Display the result if the attribute exists.
if (isDef)
  TemplateContainerAttribute tca =
    (TemplateContainerAttribute)Attribute.GetCustomAttribute(pInfo, typeof(TemplateContainerAttribute));
  Response.Write("The binding direction is: " + tca.BindingDirection.ToString());

.NET Framework
Available since 2.0
Return to top