Control.UniqueID Control.UniqueID Control.UniqueID Control.UniqueID Property

public:
 virtual property System::String ^ UniqueID { System::String ^ get(); };

[System.ComponentModel.Browsable(false)]
public virtual string UniqueID { get; }

member this.UniqueID : string

Public Overridable ReadOnly Property UniqueID As String

プロパティ値

例

次の例ではArrayList 、オブジェクトを作成し、3つのテキスト文字列をRepeater設定します。次に、ページArrayListが読み込まれるときに、Web サーバーコントロールを内のデータにバインドします。The following example creates an ArrayList object and populates it with three text strings, then binds a Repeater Web server control to the data in the ArrayList when the page is loaded. このコードは、 UniqueIDデータバインディング中に生成された各子コントロールのプロパティを取得します。The code gets the UniqueID property for each child control generated during data binding. このコードは、3つのLabelバージョンのコントロールをUniqueID生成し、そのプロパティ値をページに書き込みます。The code generates three versions of the Label control and writes their UniqueID property values to the page.

<script language="c#" runat="server">
    
  void Page_Load(Object sender, EventArgs e) 
  {
      StringBuilder sb = new StringBuilder();
      sb.Append("Container: " + 
          MyDataList.NamingContainer.ToString() + "<p>");

      ArrayList a = new ArrayList();
      a.Add("A");
      a.Add("B");
      a.Add("C");

      MyDataList.DataSource = a;
      MyDataList.DataBind();

      for (int i = 0; i < MyDataList.Controls.Count; i++)
      {
          Label l = 
              (Label)((RepeaterItem)MyDataList.Controls[i]).FindControl("MyLabel");
          sb.Append("Container: " + 
              ((RepeaterItem)MyDataList.Controls[i]).NamingContainer.ToString() + 
              "<p>");
          sb.Append("<b>" + l.UniqueID + "</b><p>");
      }
      ResultsLabel.Text = sb.ToString();
}
</script>

  <script language="vb" runat="server">
      
      Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
          Dim sb As New StringBuilder()
          sb.Append("Container: " + _
          MyDataList.NamingContainer.ToString() + "<p>")

          Dim a As New ArrayList()
          a.Add("A")
          a.Add("B")
          a.Add("C")

          MyDataList.DataSource = a
          MyDataList.DataBind()
    
          Dim i As Integer
          Dim l As Label
          For i = 0 To MyDataList.Controls.Count - 1
              l = CType(CType(MyDataList.Controls(i), RepeaterItem).FindControl("MyLabel"), Label)
              sb.Append("Container: " & _
                 CType(MyDataList.Controls(i), RepeaterItem).NamingContainer.ToString() & _
                 "<p>")
              sb.Append("<b>" & l.UniqueID.ToString() & "</b><p>")
          Next
          ResultsLabel.Text = sb.ToString()
      End Sub
</script>

注釈

このプロパティは、プロパティIDにサーバーコントロールの名前UniqueID付けコンテナーの識別子が含まれている点で、プロパティとは異なります。This property differs from the ID property, in that the UniqueID property includes the identifier for the server control's naming container. この識別子は、ページ要求が処理されるときに自動的に生成されます。This identifier is generated automatically when a page request is processed.

このプロパティは、繰り返されるデータバインディングサーバーコントロール内に含まれるサーバーコントロールを区別するために特に重要です。This property is particularly important in differentiating server controls contained within a data-binding server control that repeats. 繰り返しコントロールRepeater( DataList 、DetailsView GridView 、、、および Web サーバーコントロール) (または、データバインド時に繰り返し機能を含む、作成したカスタムサーバーコントロール) は、次のように機能します。 FormView子コントロールのコンテナーに名前を付けます。The repeating control, which are Repeater, DataList, DetailsView, FormView, and GridView Web server controls (or any custom server controls that you create that include repeating functionality when data bound), serves as the naming container for its child controls. これは、その子コントロールに対して一意の名前空間を作成IDし、そのプロパティ値が競合しないようにすることを意味します。This means that it creates a unique namespace for its child controls so that their ID property values do not conflict.

Labelたとえば、ASP.NET Web サーバーコントロールをRepeaterサーバーコントロールに追加IDし、 RepeaterコントロールにLabelというプロパティ値MyLabel IDを割り当て、次のようにします。MyRepeater.For example, if you include an ASP.NET Label Web server control in a Repeater server control, and assign the Label control an ID property value of MyLabel, and the Repeater an ID of MyRepeater. 3つのエントリを持つRepeater ArrayListオブジェクトにデータをバインドする場合、 Labelサーバー UniqueIDコントロールの各インスタンスに対して生成さMyRepeater$ctl00$MyLabelれるMyRepeater$ctl01$MyLabelプロパティはMyRepeater$ctl02$MyLabel、、およびです。If you bind data to the Repeater to an ArrayList object with three entries, the resulting UniqueID properties for each instance of the Label server controls are MyRepeater$ctl00$MyLabel, MyRepeater$ctl01$MyLabel, and MyRepeater$ctl02$MyLabel.

適用対象

こちらもご覧ください

• ID ID ID ID
• NamingContainer NamingContainer NamingContainer NamingContainer