ControlCollection.Item[Int32] 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得在 ControlCollection 物件中指定索引位置之伺服器控制項的參考。
public:
virtual property System::Web::UI::Control ^ default[int] { System::Web::UI::Control ^ get(int index); };public virtual System.Web.UI.Control this[int index] { get; }member this.Item(int) : System.Web.UI.ControlDefault Public Overridable ReadOnly Property Item(index As Integer) As Control參數
- index
- Int32
在 ControlCollection 中伺服器控制項的位置。
屬性值
控制項的參考。
例外狀況
index 參數小於零，或大於等於 Count。
範例
下列程式碼範例會 Item[] 使用 屬性來指定方法呼叫中 Remove 移除之子控制項的索引位置。 這是由 myButton.Controls.Remove 語法所執行。
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Page_Load(Object Sender,EventArgs e)
{
Response.Write("<h2>Sample for ControlCollection Class</h2>");
LiteralControl myLiteralControl
= new LiteralControl("ChildControl1");
myButton.Controls.Add(myLiteralControl);
myButton.Controls.AddAt(1,new LiteralControl("ChildControl2"));
System.Array myControlCollectionArray
= Array.CreateInstance(typeof(object),
myButton.Controls.Count);
myButton.Controls.CopyTo(myControlCollectionArray,0);
IEnumerator myEnumerator1 =
myControlCollectionArray.GetEnumerator();
while (myEnumerator1.MoveNext())
{
object myObject = myEnumerator1.Current;
if(myObject.GetType().Equals(typeof(LiteralControl)))
{
LiteralControl childControl =
(LiteralControl)myEnumerator1.Current;
Response.Write("<p style=\"font-weight:bold\">");
Response.Write("This is the text of the child Control:"
+ Server.HtmlEncode(childControl.Text));
}
}
myButton.Controls.Remove(myButton.Controls[0]);
Response.Write("</p><p style=\"font-weight:bold\">");
Response.Write("ChildControl1 is removed<br />");
Response.Write("The count of ControlCollection = "
+ myButton.Controls.Count.ToString() + "</p>");
myButton.Controls.Clear();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Untitled Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Button ID="myButton" Text="Sample ServerControl"
Runat="server"></asp:Button>
</div>
</form>
</body>
</html>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
Response.Write("<h2>Sample for ControlCollection Class</h2>")
Dim myLiteralControl As LiteralControl _
= New LiteralControl("ChildControl1")
myButton.Controls.Add(myLiteralControl)
myButton.Controls.AddAt(1, New LiteralControl("ChildControl2"))
Dim myControlCollectionArray As System.Array = _
Array.CreateInstance(GetType(Object), _
myButton.Controls.Count)
myButton.Controls.CopyTo(myControlCollectionArray, 0)
Dim myEnumerator1 As IEnumerator = _
myControlCollectionArray.GetEnumerator()
While myEnumerator1.MoveNext()
Dim myObject As Object = myEnumerator1.Current
If myObject.GetType().Equals(GetType(LiteralControl)) Then
Dim childControl As LiteralControl _
= CType(myEnumerator1.Current, LiteralControl)
Response.Write("<p style=""font-weight:bold"">")
Response.Write("This is the text of the child Control:" _
& Server.HtmlEncode(childControl.Text))
End If
End While
myButton.Controls.Remove(myButton.Controls(0))
Response.Write("</p><p style=""font-weight:bold"">ChildControl1 is removed")
Response.Write("<br />The count of ControlCollection = " _
& myButton.Controls.Count.ToString() & "</p>")
myButton.Controls.Clear()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Sample for ControlCollection Class</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Button ID="myButton" Text="Sample ServerControl"
Runat="server"></asp:Button>
</div>
</form>
</body>
</html>
