ClientIDMode Wyliczenie

  • Odwołanie

Definicja

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

Określa, w jaki sposób ASP.NET generuje ClientID dla kontrolki, do których można uzyskać dostęp w skryscie klienta.

public enum class ClientIDMode
public enum ClientIDMode
type ClientIDMode = 
Public Enum ClientIDMode
Dziedziczenie
Object
ValueType
Enum
ClientIDMode

Pola

AutoID 1

Wartość ClientID jest generowana przez łączenie ID wartości każdego nadrzędnego kontenera nazewnictwa z ID wartością 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 jest jedynym, który był dostępny w wersjach ASP.NET starszych niż ASP.NET 4.
Inherit 0

Kontrolka dziedziczy ClientIDMode ustawienie jego NamingContainer kontrolki.
Predictable 2

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 nadrzędnego kontenera nazewnictwa z ID wartością kontrolki. Jeśli kontrolka jest kontrolką powiązaną z danymi, która generuje wiele wierszy, wartość pola danych określonego ClientIDRowSuffix we właściwości jest dodawana 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. Każdy segment jest oddzielony znakiem podkreślenia (_).
Static 3

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.

Przykłady

W poniższym przykładzie pokazano Label kontrolki, które znajdują się w kontrolce ListView . W kontrolce ListViewClientIDMode właściwość jest ustawiona na Przewidywalne, a właściwość jest ustawiona ClientIDRowSuffix na ProductIDwartość . Za pomocą skryptu klienta można uzyskać dostęp do określonego Label wystąpienia obiektu na ProductID podstawie wartości wystąpienia, do którego próbujesz uzyskać dostęp.

W tym przykładzie tworzony jest kod HTML z trzema ProductIDLabel kontrolkami. Po uruchomieniu strony identyfikatory kontrolek będą następujące:

  • 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

Wyliczenie jest używane ClientIDMode podczas ustawiania ClientIDMode właściwości dla kontrolki. Wartość przypisana ClientIDMode do właściwości określa sposób generowania ClientID właściwości. Wartość ClientID właściwości jest renderowana jako id atrybut w adiustacji i jest to wartość używana do uzyskiwania dostępu do kontroli z poziomu skryptu klienta. Wartość przypisana do ClientIDMode właściwości nie ma wpływu na ID właściwość kontrolki serwera, tylko id atrybut odpowiedniego elementu HTML.

Wartość domyślna ClientIDMode strony to Przewidywalne. Wartość domyślna kontrolki ClientIDMode to Dziedzicz.

Ponieważ domyślnym ustawieniem kontrolek jest Dziedzicz, domyślny tryb generowania jest przewidywalny. (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ą wartość witryny na AutoID w pliku Web.config).

Wartość dla wszystkich stron w witrynie sieci Web można ustawić ClientIDMode , ustawiając element pages w pliku Web.config witryny. Wartość strony można ustawić ClientIDMode w dyrektywie @ Page .

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

Dotyczy

Zobacz też