Control.RenderControl メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
サーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を格納します。
オーバーロード
RenderControl(HtmlTextWriter) |
指定の HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を保存します。 |
RenderControl(HtmlTextWriter, ControlAdapter) |
指定した ControlAdapter オブジェクトを使用して、指定した HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力します。 |
RenderControl(HtmlTextWriter)
指定の HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力し、トレースが有効である場合はコントロールに関するトレース情報を保存します。
public:
void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);
public:
virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);
public void RenderControl (System.Web.UI.HtmlTextWriter writer);
public virtual void RenderControl (System.Web.UI.HtmlTextWriter writer);
member this.RenderControl : System.Web.UI.HtmlTextWriter -> unit
abstract member RenderControl : System.Web.UI.HtmlTextWriter -> unit
override this.RenderControl : System.Web.UI.HtmlTextWriter -> unit
Public Sub RenderControl (writer As HtmlTextWriter)
Public Overridable Sub RenderControl (writer As HtmlTextWriter)
パラメーター
- writer
- HtmlTextWriter
コントロールの内容を受け取る HtmlTextWriter オブジェクト。
例
次の例では、 RenderChildren カスタム サーバー コントロールの メソッドをオーバーライドします。 現在のコントロールのオブジェクトに子コントロール ControlCollection があるかどうかを判断します。 その場合は、 プロパティを Count 使用してコレクションを反復処理します。 各子コントロールが検出されると、 メソッドを RenderControl 使用して、子コントロールとそのすべての子コントロールが含まれているページにレンダリングされます。 XhtmlTextWriterこのメソッドに渡されるオブジェクトは、 メソッドによってRenderインスタンス化されます。
// 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
注釈
サーバー コントロールの Visible プロパティが に true
設定されている場合、このメソッドは、ページに対してトレースが有効になっているかどうかを判断します。 その場合、コントロールに関連付けられているトレース情報が格納され、サーバー コントロールのコンテンツがページにレンダリングされます。
このメソッドは、レンダリング中にページによって自動的に呼び出されますが、カスタム コントロール開発者はオーバーライドできます。
こちらもご覧ください
適用対象
RenderControl(HtmlTextWriter, ControlAdapter)
指定した ControlAdapter オブジェクトを使用して、指定した HtmlTextWriter オブジェクトにサーバー コントロールの内容を出力します。
protected:
void RenderControl(System::Web::UI::HtmlTextWriter ^ writer, System::Web::UI::Adapters::ControlAdapter ^ adapter);
protected void RenderControl (System.Web.UI.HtmlTextWriter writer, System.Web.UI.Adapters.ControlAdapter adapter);
member this.RenderControl : System.Web.UI.HtmlTextWriter * System.Web.UI.Adapters.ControlAdapter -> unit
Protected Sub RenderControl (writer As HtmlTextWriter, adapter As ControlAdapter)
パラメーター
- writer
- HtmlTextWriter
コントロールの内容を受け取る HtmlTextWriter。
- adapter
- ControlAdapter
表示を定義する ControlAdapter。
注釈
ASP.NET Web ページは、Web から情報を要求できるさまざまなデバイスやブラウザーで使用できます。 プロパティは Adapter 、 ControlAdapter 要求しているデバイスまたはブラウザーの画面にコントロールをレンダリングする オブジェクトを返します。
アダプターの詳細については、「 アダプティブ コントロール動作のアーキテクチャの概要」を参照してください。
サーバー コントロールの Visible プロパティが に true
設定され、ページに対してトレースが有効になっている場合、コントロールに関連付けられているトレース情報がキャプチャされます。
注意 (継承者)
カスタム コントロールで メソッドをオーバーライドする RenderControl(HtmlTextWriter, ControlAdapter) 場合は、基本クラス メソッドを呼び出して、トレース情報が正しくキャプチャされていることを確認します。
こちらもご覧ください
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示