Share via


Server-Side Object Tag Syntax

Declara e cria COM e.NET Framework objetos em uma página Web Forms.

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

Atributos

  • class
    Especifica o.NET Framework para criar.

  • classID
    Especifica o componente COM para criar usando o identificador de classe do componente.

  • id
    Nome exclusivo para usar ao referenciar o objeto no código subseqüente.

  • lateBinding
    Indica se as APIs de ligação atrasada deve ser usadas com componentes COM que foram processadas por Type Library Importer (Tlbimp. exe). trueindica que as APIs de ligação atrasada deve ser usadas; falseindica que a vinculação antecipada APIs deve ser usadas. O padrão é false.

  • progID
    Especifica o componente COM para criar, especificando o identificador de programação do componente.

  • runat
    Deve ser definido como server para o objeto a ser executado dentro do ASP.NET. Todos os valores do servidor não-fazer com que o compilador de página que assumir que o <object> marca deve ser enviada ao cliente para manipular.

Comentários

Quando o ASP.O analisador de página NET encontra um servidor <object> marca em um arquivo. aspx, ele gera uma propriedade somente leitura na página, usando o id atributo da marca, como o nome de propriedade. A propriedade somente leitura, em seguida, é configurada para criar uma instância do objeto na primeira utilização. A instância resultante não será adicionada como um objeto dentro da árvore de controle de servidor hierárquica da página; em vez disso, ela é tratada como uma declaração de variável não-UI (user interface).

O classid, progid, e class atributos são mutuamente exclusivas. Você não pode incluir mais de um desses atributos em um único servidor <object> marca. No entanto, você pode incluir vários do lado do servidor <object> marcas em uma página de Web Forms e usar esses atributos em marcas diferentes.

Observação

Por motivos de segurança gerenciados controles usando o <object> não há suporte para o protocolo de acesso de marca e o arquivo em uma página HTML.Portanto, você não pode fazer referência a arquivos diretamente de dentro da marca.

Exemplo

O exemplo de código a seguir usa a sintaxe de objeto do lado do servidor para criar uma instância de ArrayList .Classe do NET Framework em uma página de Web Forms.

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

Consulte também

Conceitos

Visão geral da sintaxe de página da Web ASP.NET

Introdução à programação de páginas da Web do ASP.NET