Sintaxe da marca OBJECT do lado do servidor

Artigo
08/25/2010

Declara e cria objetos COM e .NET estrutura em uma página de 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 a classe do .NET estrutura para criar.
classID
Especifica o componente COM para criar usando o identificador de classe do componente.
id
Nome exclusivo a ser usado ao fazer referência o objeto no código subseqüente.
lateBinding
Indica se as APIs de ligação tardia deve ser usadas com componentes COM que foram processadas pelo Type biblioteca Importer (Tlbimp.exe). true indica que deve ser usadas APIs de ligação tardia; false indica que APIs de ligação inicial deve ser usadas. O padrão é false.
progID
Especifica o componente COM para criar especificando o identificador programático do componente.
runat
Deve ser definido como server para o objeto seja executado no ASP.NET. Todos os valores não servidor com que o compilador de página pressupõem que o <object> marca deve ser enviada ao cliente para manipular.

Comentários

Quando o analisador de páginas ASP.NET encontra um lado do servidor <object> marca em um arquivo .aspx, ele gera uma propriedade somente leitura na página, usando o id atributo da marca sistema autônomo o nome de propriedade. Propriedade somente leitura, em seguida, é configurada para criar uma instância do objeto no primeiro uso. A instância resultante não é adicionada sistema autônomo um objeto dentro árvore de controle de servidor hierárquica da página de; em vez disso, ele será tratado sistema autônomo uma declaração de variável não-usuário interface (UI).

The classid, progid, e class atributos são mutuamente exclusivo. Não é possível incluir mais de um desses atributos em um servidor único <object> marca. No entanto, você pode, incluir vários servidor <object> Rótulos em uma Web Forms da página e usam esses atributos nas Rótulos diferentes.

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

Exemplo

O exemplo de código a seguir usa a sintaxe do objeto de servidor para criar uma instância do ArrayList Classe do .NET estrutura 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 a páginas da Web do ASP.NET

Partilhar via