.NET Framework Class Library
IDReferencePropertyAttribute Class

Updated: November 2007

Defines an attribute applied to properties that contain ID references. This class cannot be inherited.

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

Visual Basic (Declaration)
<AttributeUsageAttribute(AttributeTargets.Property)> _
<AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level := AspNetHostingPermissionLevel.Minimal)> _
Public NotInheritable Class IDReferencePropertyAttribute _
    Inherits Attribute
Visual Basic (Usage)
Dim instance As IDReferencePropertyAttribute
C#
[AttributeUsageAttribute(AttributeTargets.Property)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class IDReferencePropertyAttribute : Attribute
Visual C++
[AttributeUsageAttribute(AttributeTargets::Property)]
[AspNetHostingPermissionAttribute(SecurityAction::LinkDemand, Level = AspNetHostingPermissionLevel::Minimal)]
public ref class IDReferencePropertyAttribute sealed : public Attribute
J#
/** @attribute AttributeUsageAttribute(AttributeTargets.Property) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public final class IDReferencePropertyAttribute extends Attribute
JScript
public final class IDReferencePropertyAttribute extends Attribute

The IDReferencePropertyAttribute class is applied to properties that contain ID references. ContentPlaceHolderID is an example of a property that contains an ID reference. When this attribute is applied, designers can provide additional functionality during design time, such as listing IDs.

The following code example demonstrates how the IDReferencePropertyAttribute attribute is applied to a property that evaluates to a string. In this example, the DataSourceID member identifies a data source control and therefore specifies the DataSourceControl type.

Visual Basic
' This class implements a custom data source control.
Public Class SomeDataBoundControl
    Inherits DataBoundControl

    <IDReferencePropertyAttribute(GetType(DataSourceControl))>  _
    Public Shadows Property DataSourceID() As String 
        Get
            Return MyBase.DataSourceID
        End Get
        Set
            MyBase.DataSourceID = value
        End Set
    End Property

End Class 'SomeDataBoundControl 

C#
// This class implements a custom data source control.
public class SomeDataBoundControl : DataBoundControl
{   
    [ IDReferencePropertyAttribute(typeof(DataSourceControl)) ]        
    new public string DataSourceID {
        get {
            return base.DataSourceID;
        }
        set {
            base.DataSourceID = value;
        }
    }

}

System..::.Object
  System..::.Attribute
    System.Web.UI..::.IDReferencePropertyAttribute
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Page view tracker