Page.VerifyRenderingInServerForm(Control) Yöntem

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.dll

Belirtilen ASP.NET sunucu denetimi için çalışma zamanında bir HtmlForm denetimin işlendiğini onaylar.

public:
 virtual void VerifyRenderingInServerForm(System::Web::UI::Control ^ control);

public virtual void VerifyRenderingInServerForm (System.Web.UI.Control control);

abstract member VerifyRenderingInServerForm : System.Web.UI.Control -> unit
override this.VerifyRenderingInServerForm : System.Web.UI.Control -> unit

Public Overridable Sub VerifyRenderingInServerForm (control As Control)

Parametreler

control

Control

Denetimde HtmlForm gerekli olan ASP.NET sunucu denetimi.

Özel durumlar

HttpException

Belirtilen sunucu denetimi, çalışma zamanında sunucu denetiminin açma ve kapatma etiketleri HtmlForm arasında yer almaz.

ArgumentNullException

Doğrulanması gereken denetim: null.

Örnekler

Aşağıdaki kod örneği, özel bir sunucu denetiminin yöntemini geçersiz kılar Page.Render . Bu denetim içeriğini bir sayfaya yazdığında, denetimin VerifyRenderingInServerForm bir HtmlForm denetimin açma ve kapatma etiketleri arasında göründüğünden emin olmak için yöntemini kullanır.

// 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);
}

' 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

Açıklamalar

Etiketlerin içinde <form runat=server> olması gereken denetimler, etiketlerin dışına yerleştirilirse bir hata iletisi gösterilmesi için işlenmeden önce bu yöntemi çağırabilir. Geri gönderen veya kayıtlı betik bloklarına bağımlı olan denetimler, yöntemin Control.Render geçersiz kılmasında bu yöntemi çağırmalıdır. Sunucu form öğesini işlemek için farklı bir yönteme sahip sayfalar, farklı koşullar altında bir özel durum oluşturmak için bu yöntemi geçersiz kılabilir.

Geri gönderilen veya istemci tarafı betiği kullanan sunucu denetimleri, sunucu denetimi (<form runat="server">) etiketleri içine HtmlForm alınmazsa çalışmaz. Bu denetimler, denetime dahil HtmlForm edilmediklerinde net bir hata iletisi sağlamak için işlendiğinde bu yöntemi çağırabilir.

Özel bir sunucu denetimi geliştirirken, herhangi bir tür giriş etiketi için yöntemini geçersiz kıldığınızda Render bu yöntemi çağırmak yaygın bir durumdur. Giriş denetimi çağrılırsa GetPostBackEventReferenceveya istemci betiği yayıyorsa bu özellikle önemlidir. Bileşik sunucu denetiminin bu çağrıyı yapması gerekmez.