按一下以給予評分及指教
MSDN
MSDN Library
.NET 開發
先前版本
類別庫參考
System.Web.UI
Page 類別
Page 方法
 VerifyRenderingInServerForm 方法

  開啟低頻寬檢視
本頁僅適用於
Microsoft Visual Studio 2005/.NET Framework 2.0

其他版本也適用於下列軟體:
.NET Framework 類別庫
Page.VerifyRenderingInServerForm 方法

確認在 Run Time 時期呈現了所指定 ASP.NET 伺服器控制項的 HtmlForm 控制項。

命名空間: System.Web.UI
組件: System.Web (在 system.web.dll 中)

Visual Basic (宣告)
Public Overridable Sub VerifyRenderingInServerForm ( _
    control As Control _
)
Visual Basic (使用方式)
Dim instance As Page
Dim control As Control

instance.VerifyRenderingInServerForm(control)
C#
public virtual void VerifyRenderingInServerForm (
    Control control
)
C++
public:
virtual void VerifyRenderingInServerForm (
    Control^ control
)
J#
public void VerifyRenderingInServerForm (
    Control control
)
JScript
public function VerifyRenderingInServerForm (
    control : Control
)

參數

control

HtmlForm 控制項中的必要 ASP.NET 伺服器控制項。

例外狀況類型條件

HttpException

指定的伺服器控制項在 Run Time 時期並不包含於 HtmlForm 伺服器控制項的開頭和結尾標記之間。

必須位在 <form runat=server> 標記以內的控制項,可以先呼叫這個方法,才進行呈現,這樣一來,如果控制項位在標記以外,便會顯示錯誤訊息。會回傳或是依賴已註冊指令碼區塊的控制項,應該呼叫這個方法來覆寫 Control.Render 方法。對於伺服器表單項目有不同呈現方法的網頁,可以覆寫這個方法以便在不同條件下擲回例外狀況。

會回傳或使用用戶端指令碼的伺服器控制項,如果未放在 HtmlForm 伺服器控制項 (<form runat="server">) 標記之內,將無法運作。這些控制項可以呼叫這個方法來呈現清楚的錯誤訊息 (當它們未被封入 HtmlForm 控制項時)。

當您開發自訂伺服器控制項時,通常會呼叫這個方法來覆寫任何類型的輸入標記之 Render 方法。這在輸入控制項呼叫 GetPostBackEventReference 或發出用戶端指令碼時特別重要。複合伺服器控制項並不需要做這個呼叫。

下列程式碼範例將示範覆寫自訂伺服器控制項中的 Page.Render 方法。當這個控制項將其內容寫入頁面時,它會使用 VerifyRenderingInServerForm 方法來確定控制項出現在 HtmlForm 控制項的開頭和結尾標記之間。

Visual Basic
' Override the Render method to ensure that this control
' is nested in an HtmlForm server control, between a <form runat=server>
' opening tag and a </form> closing tag.
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)

    ' Ensure that the control is nested in a server form.
    If Not (Page Is Nothing) Then
        Page.VerifyRenderingInServerForm(Me)
    End If

    MyBase.Render(writer)

End Sub

C#
// Override the Render method to ensure that this control
// is nested in an HtmlForm server control, between a <form runat=server>
// opening tag and a </form> closing tag.
protected override void Render(HtmlTextWriter writer) {
    // Ensure that the control is nested in a server form.
    if (Page != null) {
        Page.VerifyRenderingInServerForm(this);
    }
    base.Render(writer);
}
J#
// Override the Render method to ensure that this control
// is nested in an HtmlForm server control, between a <form runat=server>
// opening tag and a </form> closing tag.
protected void Render(HtmlTextWriter writer)
{
    // Ensure that the control is nested in a server form.
    if (get_Page() != null) {
        get_Page().VerifyRenderingInServerForm(this);
    }
    super.Render(writer);
} //Render

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、1.1、1.0
社群內容   什麼是社群內容?
新增內容 RSS  註解
Processing
© 2009 Microsoft Corporation. 著作權所有,並保留一切權利。 使用規定  |  商標  |  隱私權聲明
Page view tracker