Control.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 virtual string SkinID { get; set; }
member this.SkinID : string with get, set
Public Overridable Property SkinID As String



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



スタイル シートが既に適用されています。The style sheet has already been applied.


Page_PreInit イベントが既に発生しています。The Page_PreInit event has already occurred.


コントロールが既に Controls コレクションに追加されました。The control was already added to the Controls collection.


コントロールで使用できるスキンは、テーマディレクトリ内の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 settings 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 themes. ID を持つスキンがコントロールに対して定義されている場合 Image 、そのスキンは、 Image SkinID その id に設定されているプロパティを持つコントロールにのみ適用されます。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.

テーマディレクトリ内のスキンファイルに、指定されたプロパティを持つスキンが含まれていない場合は SkinIDArgumentException 実行時に例外がスローされます。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.