Syntaxe značek objektů na straně serveru

Článek
08/11/2011

Deklaruje a vytvoří objekty COM a .NET Framework ve stránce Webových formulářů.

<object id="id" 
        runat="server" 
        latebinding="true|false" 
        class="Class Name">
<object id="id" 
        runat="server" 
        latebinding="true|false" 
        progid="COM ProgID"/>
<object id="id" 
        runat="server" 
        latebinding="true|false" 
        classid="COM ClassID"/>

v případě vícehodnotových atributů

class
Určuje třídu rozhraní .NET Framework pro vytvoření.
classID
Určuje komponentu modelu COM pro vytvoření pomocí identifikátoru třídy komponenty.
id
Jedinečný název, který má být použit při odkazování se na objekt v následujícím kódu.
lateBinding
Označuje, zda by měla být použita dynamicky vázaná rozhraní API s komponentami modelu COM, které byly zpracovány importérem knihovny typů Type Library Importer (Tlbimp.exe). true označuje, že by měla být použita dynamická vazba rozhraní API. false označuje, že by měla být použita časná vazba rozhraní API. Výchozí je false.
progID
Určuje komponentu modelu COM pro vytvoření zadáním programového identifikátoru dané komponenty.
runat
Musí být nastaven na server u objektů spouštěných v rámci technologie ASP.NET. Všechny neserverové hodnoty způsobí, že bude kompilátor stránky předpokládat, že by měla být značka <object> zaslána klientovi ke zpracování.

Poznámky

Pokud analyzátor stránky technologie ASP.NET narazí na serverovou značku <object> v souboru ASPX, vygeneruje na stránce vlastnost pouze pro čtení, kde použije atribut značky id jako vlastnost name. Vlastnost pouze pro čtení je potom nakonfigurován tak, aby vytvořila instanci objektu při prvním použití. Výsledná instance není přidána jako objekt do hierarchické stromové struktury ovládacích prvků stránky. Místo toho bude zpracována jako deklarace proměnné nepatřící do uživatelského rozhraní (UI).

Atributy classid, progid a class se vzájemně vylučují. Nemůžete zahrnout více než jeden z těchto atributů v jediné serverové značce <object>. Je však možné zahrnout více serverových značek <object> na stránce Webových formulářů a použít tyto atributy v různých značkách.

Poznámka
Z bezpečnostních důvodů nejsou podporovány spravované ovládací prvky používající značku <object> a protokol pro přístup k souborům ze stránky HTML.Proto není možné vytvořit odkaz na soubory přímo z vnitřku značky.

Příklad

Následující příklad kódu používá syntaxi objektů na straně serveru k vytvoření instance třídy ArrayList rozhraní .NET framework na stránce Webových formulářů.

<%@Page language="C#" %>
<html>
   <object id="items" class="System.Collections.ArrayList" runat="server" />
   <script language="C#" runat=server>
      void Page_Load(Object sender, EventArgs e) {
         items.Add("One");
         items.Add("Two");
         items.Add("Three");

         MyList.DataSource = items;
         MyList.DataBind();
      }
   </script>

   <body>
      <form id="form1" runat="server">
      <asp:datalist id="MyList" runat=server>
         <ItemTemplate>
            Here is a value: <%# Container.DataItem %>
         </ItemTemplate>
      </asp:datalist>
      </form1>
   </body>
</html>

<%@Page language="VB" %>
<html>
   <object id="items" class="System.Collections.ArrayList" runat="server" />
   <script language="VB" runat=server>
      Sub Page_Load(Sender As Object, E As EventArgs)
         items.Add("One")
         items.Add("Two")
         items.Add("Three")

         MyList.DataSource = items
         MyList.DataBind()
      End Sub
   </script>

   <body>
      <form id="form1" runat="server">
      <asp:datalist id="MyList" runat=server>
         <ItemTemplate>
            Here is a value: <%# Container.DataItem %>
         </ItemTemplate>
      </asp:datalist>
      </form1>
   </body>
</html>

Viz také

Koncepty

Přehled syntaxe webová stránky technologie ASP.NET

Úvod do programování webových stránek v technologii ASP.NET

Sdílet prostřednictvím