ControlDesigner.UsePreviewControl プロパティ

.NET Framework クラス ライブラリ リファレンス

ControlDesigner.UsePreviewControl プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Protected Overridable ReadOnly
 Property UsePreviewControl As Boolean

Visual Basic (使用法)

Dim value As Boolean

value = Me.UsePreviewControl

C#

protected virtual bool UsePreviewControl {
 get; }

C++

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

J#

/** @property */
protected boolean get_UsePreviewControl ()

JScript

protected function get UsePreviewControl
 () : boolean

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

解説

UsePreviewControl プロパティが true の場合、ViewControl プロパティはコントロールの一時コピーを返します。一時コントロールに加えられた変更は、ドキュメントに永続化されません。

UsePreviewControl プロパティが false の場合、ViewControl プロパティはコントロールの Component プロパティのインスタンスを返します。コントロールのインスタンスに加えられた変更は永続化されます。

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

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ControlDesigner クラス
ControlDesigner メンバ
System.Web.UI.Design 名前空間
SupportsPreviewControlAttribute
ViewControl
GetViewRendering
PreviewControlDesigner
その他の技術情報
ASP.NET コントロール デザイナの概要
Web フォームのデザイン時サポート