BaseTemplateParser.GetUserControlType メソッド

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

BaseTemplateParser.GetUserControlType メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

このメソッドは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

仮想パスによって指定される UserControl オブジェクトの型をコンパイルして返します。

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

Visual Basic (宣言)

Protected Friend Function
 GetUserControlType ( _
    virtualPath As String _
) As Type

Visual Basic (使用法)

Dim virtualPath As String
Dim returnValue As Type

returnValue = Me.GetUserControlType(virtualPath)

C#

protected internal Type GetUserControlType (
    string virtualPath
)

C++

protected public:
Type^ GetUserControlType (
    String^ virtualPath
)

J#

protected Type GetUserControlType (
    String virtualPath
)

JScript

protected internal function
 GetUserControlType (
    virtualPath : String
) : Type

パラメータ

virtualPath

UserControl の仮想パス。

戻り値
ユーザー コントロールの型。

例外

例外の種類	条件
HttpException	virtualPath によって指定される UserControl がコンパイルなしとマークされています。 または パーサーが、UserControl への仮想参照を許可していません。

解説

PageParserFilter オブジェクトが定義され、その AllowVirtualReference プロパティが false である場合、GetUserControlType メソッドは HttpException 例外を生成します。

また、仮想パスによって参照されている UserControl オブジェクトがコンパイルなしとしてマークされている場合も、HttpException 例外がスローされます。UserControl をコンパイルするには、その @ Control ディレクティブ内のコンパイル モード属性を Always フィールドに設定する必要があります。1 つのアプリケーション内のページとコントロールのコンパイル モードを設定するには、Web.config ファイルの pages 要素 (ASP.NET 設定スキーマ) の compilationMode 属性を設定します。

プラットフォーム

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

参照

関連項目
BaseTemplateParser クラス
BaseTemplateParser メンバ
System.Web.UI 名前空間
UserControl
ProcessError
CompilationMode
PageParserFilter
その他の技術情報
pages 要素 (ASP.NET 設定スキーマ)
@ Control