WebControl.SkinID プロパティ


コントロールに適用するスキンを取得または設定します。Gets or sets the skin to apply to the control.

 virtual property System::String ^ SkinID { System::String ^ get(); void set(System::String ^ value); };
public override string SkinID { get; set; }
member this.SkinID : string with get, set
Public Overrides Property SkinID As String



コントロールに適用するスキンの名前。The name of the skin to apply to the control. 既定値は、Empty です。The default is Empty.



SkinID プロパティで指定されたスキンがテーマの中に存在しません。The skin specified in the SkinID property does not exist in the theme.


コントロールで使用できるスキンは、テーマディレクトリ内の1つ以上のスキンファイルに格納されます。Skins available to a control are contained in one or more skin files in a theme directory. プロパティは、 SkinID コントロールに適用するスキンのを指定します。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 setting between controls of different types.

プロパティを設定しなかった場合 SkinID 、コントロールは既定のスキンを使用します (定義されている場合)。If you do not set the SkinID property, a control uses the default skin if one is defined. たとえば、ID のないスキンがコントロールに対して定義されている場合、 Image そのスキンは、 Image id でスキンを明示的に参照せず、テーマを無効に設定しないすべてのコントロールに適用されます。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. ID を持つスキンがコントロールに対して定義されている場合 Image 、そのスキンは、 Image SkinID がその id に設定されているコントロールにのみ適用されます。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.

テーマディレクトリ内のスキンファイルに、指定したのスキンが含まれていない場合は SkinIDArgumentException 実行時に例外がスローされます。If the skin files in a theme directory do not contain a skin with the specified SkinID, an ArgumentException exception is thrown at runtime.