WebControl.SkinID Właściwość

Definicja

Pobiera lub ustawia skórkę, która ma zostać zastosowana do kontrolki.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(true)]
public override string SkinID { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.SkinID : string with get, set
Public Overrides Property SkinID As String

Wartość właściwości

String

Nazwa skórki, która ma zostać zastosowana do kontrolki.The name of the skin to apply to the control. Wartość domyślna to Empty.The default is Empty.

Atrybuty

Wyjątki

Skórka określona we SkinID właściwości nie istnieje w motywie.The skin specified in the SkinID property does not exist in the theme.

Uwagi

Karnacje dostępne dla kontrolki są zawarte w co najmniej jednym pliku skórki w katalogu motywu.Skins available to a control are contained in one or more skin files in a theme directory. SkinIDWłaściwość określa, które z tych karnacji mają być stosowane do kontrolki.The SkinID property specifies which of these skins to apply to the control. Skórka jest specyficzna dla konkretnej kontrolki; nie można udostępniać ustawienia skórki między kontrolkami różnych typów.A skin is specific to a particular control; you cannot share skin setting between controls of different types.

Jeśli właściwość nie zostanie ustawiona SkinID , formant używa domyślnej karnacji, jeśli jest zdefiniowany.If you do not set the SkinID property, a control uses the default skin if one is defined. Na przykład, jeśli skórka bez identyfikatora jest zdefiniowana dla Image kontrolki, to karnacja ma zastosowanie do wszystkich Image kontrolek, które nie odwołują się jawnie do skórki według identyfikatora i nie są ustawione do wyłączania ich.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 theming. Jeśli skórka o IDENTYFIKATORze jest zdefiniowana dla Image kontrolki, to karnacja ma zastosowanie tylko do Image kontrolek, których SkinID wartość jest ustawiona na ten identyfikator.If a skin with an ID is defined for an Image control, then that skin applies to only Image controls whose SkinID is set to that ID.

Jeśli pliki skórki w katalogu motywu nie zawierają karnacji z określonym SkinID , ArgumentException wyjątek jest zgłaszany w czasie wykonywania.If the skin files in a theme directory do not contain a skin with the specified SkinID, an ArgumentException exception is thrown at runtime.

Dotyczy

Zobacz też