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

定義

階層構造で修飾されたサーバー コントロールの一意の ID を取得します。Gets the unique, hierarchically qualified identifier for the server control.

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

プロパティ値

サーバー コントロールの完全修飾 ID。The fully qualified identifier for the server control.

次の例では、作成、ArrayListオブジェクト、3 つのテキスト文字列を設定し、バインド、 Repeater Web サーバー コントロール内のデータをArrayListページが読み込まれるときにします。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. 繰り返しコントロールRepeaterDataListDetailsViewFormView、およびGridViewWeb サーバー コントロール (または作成したカスタム サーバーのコントロールで、データがバインドされている場合は、機能を繰り返しを含む) として機能、名前付けコンテナーの子コントロール。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.

たとえば、ASP.NET を含める場合LabelWeb サーバー コントロールで、Repeaterサーバー コントロール、および割り当て、Labelコントロール、IDプロパティの値MyLabelRepeaterIDMyRepeater.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. データをバインドする場合、RepeaterArrayList、その結果、3 つのエントリを持つオブジェクトUniqueIDの各インスタンスのプロパティ、Labelサーバー コントロールはMyRepeater$ctl00$MyLabelMyRepeater$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.

適用対象

こちらもご覧ください