ControlDesigner.UsePreviewControl プロパティ

定義

名前空間:

System.Web.UI.Design

アセンブリ:

System.Design.dll

コントロール デザイナーが一時プレビュー コントロールを使用してデザイン時 HTML マークアップを生成するかどうかを示す値を取得します。

protected:
 virtual property bool UsePreviewControl { bool get(); };

protected virtual bool UsePreviewControl { get; }

member this.UsePreviewControl : bool

Protected Overridable ReadOnly Property UsePreviewControl As Boolean

プロパティ値

Boolean

コントロール デザイナーがデザイン時プレビュー用のコントロールの一時コピーを使用する場合は、true。コントロール デザイナーがコントロール デザイナーに含まれているコントロールの Component プロパティを使用する場合は、false。

注釈

プロパティが UsePreviewControl の場合、プロパティはtrueViewControlコントロールの一時的なコピーを返します。 一時コントロールに対する変更は、ドキュメントに保持されません。

プロパティが UsePreviewControl の場合、プロパティは falseViewControl コントロールの プロパティのComponentインスタンスを返します。 コントロールのインスタンスに対する変更は保持されます。

オブジェクトの SupportsPreviewControlAttribute 設定はSupportsPreviewControl、 プロパティのUsePreviewControl値を設定するために使用されます。 したがって、 設定はSupportsPreviewControl、基底ControlDesignerクラスの プロパティによって返されるコントロールのViewControl種類を決定します。 SupportsPreviewControlAttributeコントロール デザイナーの宣言で が指定されていない場合、オブジェクトのControlDesigner動作は、 プロパティを としてfalse指定することとSupportsPreviewControl同じです。

注意 (継承者)

クラスから派生したカスタム デザイナーは、 プロパティをControlDesignerUsePreviewControlオーバーライドし、 オブジェクトをSupportsPreviewControlAttribute無視できます。 通常、プロパティが常にコントロールの ViewControl 一時的なコピーを返すようにするには、 プロパティをオーバーライドして UsePreviewControl 常に を返します true。 プロパティが常に コントロールの ViewControl インスタンスを返すようにするには、 プロパティをオーバーライドして UsePreviewControl 常に を返します false。 たとえば、 クラスは PreviewControlDesigner からControlDesigner派生し、 プロパティに対して常に をUsePreviewControl返しますtrue。

こちらもご覧ください

• SupportsPreviewControlAttribute
• ViewControl
• GetViewRendering
• PreviewControlDesigner
• ASP.NET コントロール デザイナーの概要