Control.SkinID プロパティ

定義

コントロールに適用するスキンを取得または設定します。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 コントロールに対して定義されている場合、そのスキンは SkinID プロパティがその ID に設定されている 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.

適用対象

こちらもご覧ください