Control.HasControls メソッドとは何？ わかりやすく解説 Weblio辞書 (original) (raw)

サーバー コントロールに子コントロールが含まれているかどうかを確認します。

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

Visual Basic (宣言)

Public Overridable Function HasControls As Boolean

Visual Basic (使用法)

Dim instance As Control Dim returnValue As Boolean

returnValue = instance.HasControls

C#

public virtual bool HasControls ()

C++

public: virtual bool HasControls ()

J#

public boolean HasControls ()

JScript

public function HasControls () : boolean

戻り値
コントロールに他のコントロールが格納されている場合は **true**。それ以外の場合は **false**。

解説

このメソッドは、子コントロールが存在するかどうかを確認するだけであるため、Count プロパティの不必要な呼び出しを避けることによってパフォーマンスを向上させることができます。このプロパティを呼び出すには ControlCollection オブジェクトがインスタンス化されている必要があります。子がない場合、このオブジェクトの作成はサーバーのリソースを浪費します。

継承時の注意 HasControls メソッドは、EditorBrowsableAttribute などのメタデータ属性を変更する場合のみオーバーライドしてください。属性の使用方法については、「属性を使用したメタデータの拡張」を参照してください。

使用例

Count プロパティを使用して ControlCollection オブジェクトを反復する前に、HasControls メソッドを使用してコントロールが存在するかどうかを確認する例を次に示します。

Visual Basic

If HasControls() Then Dim i As Integer For i = 0 To Controls.Count - 1 Controls(i).RenderControl(writer) Next i End If

C#

if (HasControls()) { for (int i=0; i < Controls.Count; i++) { Controls[i].RenderControl(writer); } }

J#

if (HasControls()) { for (int i = 0; i < get_Controls().get_Count(); i++) { get_Controls().get_Item(i).RenderControl(writer); } }

JScript

if (HasControls()) { for (var i : int = 0; i < Controls.Count; i++) { Controls[i].RenderControl(writer); } }

プラットフォーム

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

参照

関連項目
Control クラス
Control メンバ
System.Web.UI 名前空間
Controls
ControlCollection