Control.RenderChildren(HtmlTextWriter) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client.
protected:
virtual void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);
protected public:
virtual void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);
protected virtual void RenderChildren (System.Web.UI.HtmlTextWriter writer);
protected internal virtual void RenderChildren (System.Web.UI.HtmlTextWriter writer);
abstract member RenderChildren : System.Web.UI.HtmlTextWriter -> unit
override this.RenderChildren : System.Web.UI.HtmlTextWriter -> unit
Protected Overridable Sub RenderChildren (writer As HtmlTextWriter)
Protected Friend Overridable Sub RenderChildren (writer As HtmlTextWriter)
Parametri
- writer
- HtmlTextWriter
L'oggetto HtmlTextWriter che riceve il contenuto di cui è stato eseguito il rendering.
Esempio
Nell'esempio seguente viene eseguito l'override del RenderChildren metodo in un controllo server personalizzato. Determina se il controllo corrente dispone di controlli figlio nel relativo ControlCollection oggetto. In caso contrario, usa la Count proprietà per scorrere la raccolta. Quando rileva ogni controllo figlio, usa il metodo per eseguire il RenderControl rendering del controllo padre e tutti i relativi controlli figlio alla pagina contenente.
Il metodo sottoposto a override Render chiama quindi il metodo sottoposto a override RenderChildren .
// Override default implementation to Render children according to needs.
protected override void RenderChildren(HtmlTextWriter output)
{
if (HasControls())
{
// Render Children in reverse order.
for(int i = Controls.Count - 1; i >= 0; --i)
{
Controls[i].RenderControl(output);
}
}
}
protected override void Render(HtmlTextWriter output)
{
output.Write("<br>Message from Control : " + Message);
output.Write("Showing Custom controls created in reverse" +
"order");
// Render Controls.
RenderChildren(output);
}
' Override default implementation to Render children according to needs.
Protected Overrides Sub RenderChildren(output As HtmlTextWriter)
If HasControls() Then
' Render Children in reverse order.
Dim i As Integer
For i = Controls.Count - 1 To 0 Step -1
Controls(i).RenderControl(output)
Next
End If
End Sub
Protected Overrides Sub Render(output As HtmlTextWriter)
output.Write(("<br>Message from Control : " + Message))
output.Write(("Showing Custom controls created in reverse" + "order"))
' Render Controls.
RenderChildren(output)
End Sub
End Class
Commenti
Questo metodo notifica ASP.NET di eseguire il rendering di qualsiasi codice ASP (Active Server Pages) nella pagina. Se nella pagina non esiste alcun codice ASP, questo metodo esegue il rendering di tutti i controlli figlio per il controllo server. Questo metodo viene chiamato dal Render metodo .