Udostępnij za pośrednictwem

Control.ClientIDMode Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości.

public:
 virtual property System::Web::UI::ClientIDMode ClientIDMode { System::Web::UI::ClientIDMode get(); void set(System::Web::UI::ClientIDMode value); };
[System.Web.UI.Themeable(false)]
public virtual System.Web.UI.ClientIDMode ClientIDMode { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.ClientIDMode : System.Web.UI.ClientIDMode with get, set
Public Overridable Property ClientIDMode As ClientIDMode

Wartość właściwości

ClientIDMode

Wartość wskazująca sposób generowania ClientID właściwości. Wartość domyślna to Inherit.

Atrybuty
ThemeableAttribute

Przykłady

W poniższym przykładzie przedstawiono Label kontrolki zawarte w kontrolce ListView . W kontrolce ListViewClientIDMode właściwość jest ustawiona na Predictable , a właściwość jest ustawiona ClientIDRowSuffix na ProductID. W renderowanej kodzie HTML tworzy trzy span elementy odpowiadające trzem ProductIDLabel kontrolkom. Po uruchomieniu id strony atrybuty elementów span są ustawione na następujące wartości:

  • ListView1_ProductIDLabel_1
  • ListView1_ProductIDLabel_34
  • ListView1_ProductIDLabel_43
<asp:XmlDataSource ID="XmlDataSource1" runat="server" 
                   XPath="Products/Product">
  <Data>
    <Products>
      <Product ProductID="1"  ProductName="Chai" />
      <Product ProductID="34" ProductName="Ale" />
      <Product ProductID="43" ProductName="Coffee" />
    </Products>
  </Data>
</asp:XmlDataSource>

<asp:ListView ID="ListView1" 
              ClientIDMode="Predictable" 
              ClientIDRowSuffix="ProductID"  
              DataSourceID="XmlDataSource1" runat="server" >
  <ItemTemplate>
    ProductID: 
    <asp:Label ID="ProductIDLabel" runat="server" 
               Text='<%# Eval("ProductID") %>' />
    <br />
    ProductName:
    <asp:Label ID="ProductNameLabel" runat="server" 
               Text='<%# Eval("ProductName") %>' />
    <br />
    <br />
  </ItemTemplate>

  <LayoutTemplate>
    <div ID="itemPlaceholderContainer" runat="server">
      <span ID="itemPlaceholder" runat="server" />
    </div>
    <div>
    </div>
  </LayoutTemplate>
  
</asp:ListView>

Uwagi

ASP.NET udostępnia wiele algorytmów do generowania ClientID wartości właściwości. Wybierasz algorytm do użycia dla kontrolki, ustawiając jej ClientIDMode właściwość. Algorytmy są identyfikowane przez ClientIDMode wartości wyliczenia wymienione w poniższej tabeli.

Wartość Opis
AutoID Wartość ClientID jest generowana przez łączenie ID wartości każdego nadrzędnego kontenera nazewnictwa z wartością ID kontrolki. W scenariuszach powiązania danych, w których renderowanych jest wiele wystąpień kontrolki, wartość przyrostowa jest wstawiana przed wartością kontrolki ID . Każdy segment jest oddzielony znakiem podkreślenia (_). Ten algorytm był używany w wersjach ASP.NET starszych niż ASP.NET 4.
Static Wartość ClientID jest ustawiona na wartość ID właściwości. Jeśli kontrolka jest kontenerem nazewnictwa, kontrolka jest używana jako górna część hierarchii kontenerów nazewnictwa dla wszystkich kontrolek, które zawiera.
Predictable Ten algorytm jest używany do kontrolek, które znajdują się w kontrolkach powiązanych z danymi. Wartość ClientID jest generowana przez połączenie ClientID wartości kontenera nazewnictwa nadrzędnego z ID wartością kontrolki. Jeśli kontrolka jest kontrolką związaną z danymi, która generuje wiele wierszy, wartość pola danych określonego we ClientIDRowSuffix właściwości zostanie dodana na końcu. Dla kontrolki GridView można określić wiele pól danych. ClientIDRowSuffix Jeśli właściwość jest pusta, liczba sekwencka jest dodawana na końcu zamiast wartości pola danych. Ta liczba zaczyna się od zera i jest zwiększana o 1 dla każdego wiersza. Każdy segment jest oddzielony znakiem podkreślenia (_).
Inherit Kontrolka dziedziczy ClientIDMode ustawienie kontrolki NamingContainer .

Wartość domyślna ClientIDMode strony to Predictable. Wartość domyślna kontrolki ClientIDMode to Inherit. Ponieważ ustawieniem domyślnym dla kontrolek jest Inherit, domyślnym trybem generowania jest Predictable. (Jeśli jednak używasz programu Visual Studio do konwertowania projektu internetowego na ASP.NET 4 z wcześniejszej wersji, program Visual Studio automatycznie ustawia domyślną AutoID witrynę w pliku Web.config).

Aby uzyskać więcej informacji, zobacz ASP.NET identyfikacji kontroli serwera sieci Web.

Dotyczy

Zobacz też