ControlDesigner.UsePreviewControl プロパティ

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

protected virtual bool UsePreviewControl { get; }

member this.UsePreviewControl : bool

Protected Overridable ReadOnly Property UsePreviewControl As 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 コントロール デザイナーの概要