Sintassi di tag di oggetti del lato server

  • Articolo

Dichiara e crea oggetti COM e .NET Framework in una pagina Web Form.

<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"/>

Attributi

  • class
    Specifica la classe di .NET Framework da creare.
  • classID
    Specifica il componente COM da creare, utilizzando il relativo identificatore di classe.
  • id
    Nome univoco da utilizzare quando si fa riferimento all'oggetto in un codice successivo.
  • lateBinding
    Indica se è necessario utilizzare API ad associazione tardiva con componenti COM elaborati da Tlbimp.exe (Type Library Importer). true indica che è necessario utilizzare API ad associazione tardiva, false indica invece che è necessario utilizzare API ad associazione anticipata. L'impostazione predefinita è false.
  • progID
    Specifica il componente COM da creare, indicandone l'identificatore a livello di programmazione.
  • runat
    Per eseguire l'oggetto in ASP.NET, questo attributo deve essere impostato su server. Tutti i valori non server indicano al compilatore della pagina di inviare il tag <object> al client da gestire.

Note

Quando il parser di pagine ASP.NET individua un tag <object> del lato server in un file aspx, genera una proprietà di sola lettura nella pagina, utilizzando l'attributo id del tag come nome della proprietà. La proprietà di sola lettura viene quindi configurata per creare un'istanza dell'oggetto al primo utilizzo. L'istanza risultante non viene aggiunta come oggetto all'interno della struttura gerarchica di controlli server della pagina, ma viene considerata come dichiarazione di variabile non di interfaccia utente.

Gli attributi classid, progid e class si escludono a vicenda. Non è possibile includere più di uno di questi attributi in un unico tag <object> lato server. È invece possibile includere più tag <object> lato server in una pagina Web Form e utilizzare questi attributi in tag diversi.

Nota

Per ragioni di protezione, nelle pagine HTML non sono supportati i controlli gestiti che utilizzano il tag <object> e il protocollo di accesso ai file. Non è, pertanto, possibile fare riferimento ai file direttamente dal tag.

Esempio

Nell'esempio di codice riportato di seguito la sintassi degli oggetti lato server viene utilizzata per creare un'istanza della classe .NET Framework ArrayList in una pagina Web Form

<%@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>

Vedere anche

Concetti

Cenni preliminari sulla sintassi delle pagine Web ASP.NET
Introduzione alle pagine Web ASP.NET