SkinID Property

Control.SkinID Property

 

Gets or sets the skin to apply to the control.

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

[BrowsableAttribute(false)]
public virtual string SkinID { get; set; }

Property Value

Type: System.String

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

Exception Condition
InvalidOperationException

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.

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.

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft