EmptyControlCollection(Control) コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
EmptyControlCollection クラスの新しいインスタンスを初期化します。
public:
EmptyControlCollection(System::Web::UI::Control ^ owner);public EmptyControlCollection (System.Web.UI.Control owner);new System.Web.UI.EmptyControlCollection : System.Web.UI.Control -> System.Web.UI.EmptyControlCollectionPublic Sub New (owner As Control)パラメーター
例
次のコード例では、子コントロールをコントロールに設定しようとし、例外を引き起こします。 これは、コンテナー コントロールで子コントロールが許可されないためです。 実行可能ファイルのビルドに使用されるコマンド ラインを次に示します。
vbc /r:System.dll /r:System.Web.dll /t:library
/out:myWebAppPath/bin/vb_myEmptyControlCollection.dll
myEmptyControlCollection.vb
csc /t:library /out:myWebAppPath/bin/cs_myEmptyControlCollection.dll
myEmptyControlCollection.cs
/* File name: emptyControlCollection.cs. */
using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Collections;
namespace CustomControls
{
// Defines a simple custom control.
public class MyCS_EmptyControl : Control
{
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override ControlCollection CreateControlCollection()
/*
* Function Name: CreateControlCollection.
* Denies the creation of any child control by creating an empty collection.
* Generates an exception if an attempt to create a child control is made.
*/
{
return new EmptyControlCollection(this);
}
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void CreateChildControls()
/*
* Function Name: CreateChildControls.
* Populates the child control collection (Controls).
* Note: This function will cause an exception because the control does not allow
* child controls.
*/
{
// Create a literal control to contain the header and add it to the collection.
LiteralControl text;
text = new LiteralControl("<h5>Composite Controls</h5>");
Controls.Add(text);
}
}
}
' File name: emptyControlCollection.vb.
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Collections
Namespace CustomControls
Public Class MyVB_EmptyControl
Inherits Control
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Function CreateControlCollection() As ControlCollection
' Function Name: CreateControlCollection.
' Denies the creation of any child control by creating an empty collection.
' Generates an exception if an attempt to create a child control is made.
Return New EmptyControlCollection(Me)
End Function
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub CreateChildControls()
' Sub Name: CreateChildControls.
' Populates the child control collection (Controls).
' Note: This function will cause an exception because the control does not allow
' child controls.
Dim text As LiteralControl
text = New LiteralControl("<h5>Composite Controls</h5>")
Controls.Add(text)
End Sub
End Class
End Namespace
次のコード例では、上記で定義した空のカスタム コントロールを使用します。 この例を実行すると、例外が発生します。 ディレクティブに示されている値は、前の Register コマンド ラインを反映していることに注意してください。
<%@ Register TagPrefix="custom" Assembly="vb_myEmptyControlCollection" Namespace="CustomControls" %>
<html>
<body>
<h1>Using an Empty Control</h1>
<custom:MyVB_EmptyControl id="vbEmptyControlId" runat="server"/>
</body>
</html>
<%@ Register TagPrefix="custom" Assembly="cs_myEmptyControlCollection" Namespace="CustomControls" %>
<html>
<body>
<h1>Using an Empty Control </h1>
<custom:MyCS_EmptyControl id="csEmptyControlId" runat="server"/>
</body>
</html>