Control.SkinID Control.SkinID Control.SkinID Control.SkinID Property

定義

コントロールに適用するスキンを取得または設定します。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

プロパティ値

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

例外

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

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

または-or- コントロールが既に 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コントロールに対して定義されている場合、そのスキンは、id でスキンを明示的に参照せず、テーマを無効に設定しないすべてImageのコントロールに適用されます。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コントロールに対して定義されている場合、そのスキンは、その id に設定されているプロパティを持つSkinIDコントロールにImageのみ適用されます。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.

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

適用対象

こちらもご覧ください