Control.SkinID Property

Definition

Gets or sets the skin to apply to the control.

public:
 virtual property System::String ^ SkinID { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public virtual string SkinID { get; set; }
member this.SkinID : string with get, set
Public Overridable Property SkinID As String

Property Value

The name of the skin to apply to the control. The default is Empty.

Attributes

Exceptions

The style sheet has already been applied.

-or-

The Page_PreInit event has already occurred.

-or-

The control was already added to the Controls collection.

Remarks

Skins available to a control are contained in one or more skin files in a theme directory. The SkinID property specifies which of these skins to apply to the control. A skin is specific to a particular control; you cannot share skin settings between controls of different types.

If you do not set the SkinID property, a control uses the default skin if one is defined. For example, if a skin without an ID is defined for an Image control, then that skin applies to all Image controls that do not explicitly reference a skin by ID and that are not set to disable themes. If a skin with an ID is defined for an Image control, then that skin applies only to Image controls whose SkinID property is set to that ID.

If the skin files in a theme directory do not contain a skin with the specified SkinID property, an ArgumentException exception is thrown at run time.

Applies to

See also