Control.HasControls メソッド

.NET Framework クラス ライブラリ リファレンス

Control.HasControls メソッド

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

名前空間: 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