Compartir a través de

ELEMENT

Describe las unidades de creación básicas que representan el concepto real de un archivo de directivas.

<ELEMENT>
    <ID>value</ID>
   [<CONTEXT>...</CONTEXT>]
   [<IDENTIFIERS>...</IDENTIFIERS>]
   [<ELEMENTSET>...</ELEMENTSET>]
   [<CONSTRAINTS>...</CONSTRAINTS>]
   [<PROTOTYPES>...</PROTOTYPES>]
   [<FEATURELINKS>...</FEATURELINKS>]
</ELEMENT>

Nodos secundarios

  • ID
    Identificador que define el nodo ELEMENT. Todas las referencias al ELEMENT desde cualquier punto del archivo de directivas deben utilizar el ID. Cada ELEMENT debe contener un ID. Algunos caracteres y palabras clave no se pueden utilizar como ID. Para obtener más información, vea ID. Para obtener más información sobre la asignación de nombres a ID, vea Convenciones de nomenclatura en Enterprise Templates.
  • CONTEXT
    Opcional. Conjunto de palabras clave y atributos que la ventana Ayuda dinámica utiliza para presentar los vínculos de los temas de ayuda que están relacionados con el nodo ELEMENT principal. El uso de este nodo es opcional, pero si se utiliza, no se puede incluir más de uno en un nodo ELEMENT determinado. Para obtener más información sobre la ventana Ayuda dinámica de Visual Studio, vea El proveedor de ayuda XML y la ayuda dinámica.
  • IDENTIFIERS
    Opcional. Colección de pares de nombre/valor que permite a las plantillas de Enterprise Templates reconocer el nodo ELEMENT. El uso de este nodo es opcional, pero si se utiliza, no se puede incluir más de uno en un nodo ELEMENT determinado.
  • ELEMENTSET
    Opcional. Define otros nodos ELEMENT que se pueden utilizar como nodos secundarios del nodo ELEMENT actual. Utilice ELEMENTSET para aplicar variaciones del nodo CONSTRAINTS predeterminado de ELEMENT a estos nodos secundarios. Un proyecto podría permitir, por ejemplo, la incorporación de ciertos tipos de elementos y prohibir otros. Otro ejemplo es un elemento que permite determinados tipos de controles y no otros. En ambos casos, un nodo ELEMENTSET permitiría controlar los tipos de elementos que se pueden agregar o utilizar y los que no. El uso de este nodo es opcional, pero si se utiliza, no se puede incluir más de uno en un nodo ELEMENT determinado.
  • CONSTRAINTS
    Opcional. Conjunto de definiciones de límites y pautas que se aplican a las funciones compatibles con el nodo ELEMENT actual. El uso de este nodo es opcional, pero si se utiliza, no se puede incluir más de uno en un nodo ELEMENT determinado.
  • PROTOTYPES
    Opcional. Nodo que contiene definiciones de PROTOTYPE utilizadas para crear una instancia del proyecto, de los elementos del proyecto y de las clases. El uso de este nodo es opcional, pero si se utiliza, no se puede incluir más de uno en un nodo ELEMENT determinado.
  • FEATURELINKS
    Opcional. Conjunto de referencias a funciones del proyecto compatibles con el nodo ELEMENT actual o asociadas a él. El concepto de FEATURELINKS es complementario al concepto de CONSTRAINTS y puede simplificar el contenido del archivo de directivas. El uso de este nodo es opcional, pero si se utiliza, no se puede incluir más de uno en un nodo ELEMENT determinado.

Comentarios

Algunos ejemplos de nodos ELEMENT son proyectos de Enterprise Templates, Visual Basic, Visual C# y Visual C++ y elementos de proyecto, referencias, clases y controles. Un proyecto podría permitir, por ejemplo, la incorporación de ciertos tipos de elementos y prohibir otros. Un elemento podría permitir algunos controles pero no otros.

Nodo primario

ELEMENTS

Ejemplo

Los nodos ELEMENT son los nodos principales de un proyecto de Enterprise Templates. El ejemplo que se muestra a continuación se basa en una de las plantillas suministradas con Visual Studio .NET. Los nodos secundarios principales incluidos en este nodo ELEMENT son CONTEXT, IDENTIFIERS, PROTOTYPES y ELEMENTSET.

El nodo CONTEXT permite a un arquitecto proporcionar temas de ayuda personalizada al equipo de programadores. El nodo IDENTIFIERS que aparece a continuación proporciona una forma para que el shell de Visual Studio reconozca este nodo ELEMENT y le suministre servicios. Este nodo viene seguido del nodo PROTOTYPES, que contiene la ruta de acceso real al archivo de proyecto y el nombre del archivo. Por último, el nodo ELEMENTSET contiene información sobre los elementos incluidos y excluidos del nodo ELEMENT.

De forma predeterminada, el valor de DEFAULTACTION en el nodo ELEMENTSET excluye todos los elementos. El nodo ORDER indica que todos los elementos de una instrucción INCLUDE se evalúan antes que cualquier elemento incluido en una instrucción EXCLUDE (en este caso no aparecen nodos EXCLUDE). A continuación, el nodo ELEMENTSET muestra los nodos INCLUDE, cada uno de los cuales hace referencia a otro nodo ELEMENT que se incluye dentro del nodo ELEMENT primario.

<ELEMENT>
   <ID>etpDistributedApplicationSimple</ID>
   <CONTEXT>
      <CTXTKEYWORD>DistributedApplication</CTXTKEYWORD>
      <CTXTKEYWORD>EnterpriseFrameworks</CTXTKEYWORD>
      <CTXTATTRIBUTE>
         <NAME>Product</NAME>
         <VALUE>VS</VALUE>
      </CTXTATTRIBUTE>
      <CTXTATTRIBUTE>
         <NAME>Solution</NAME>
         <VALUE>Active</VALUE>
      </CTXTATTRIBUTE>
   </CONTEXT>
   <IDENTIFIERS>
      <IDENTIFIER>
         <TYPE>PROJECT</TYPE>
         <IDENTIFIERDATA>
            <NAME>GLOBAL:TDLELEMENTTYPE</NAME>
            <VALUE>DistributedApplicationSimple</VALUE>
         </IDENTIFIERDATA>
      </IDENTIFIER>
   </IDENTIFIERS>
   <PROTOTYPES>
      <PROTOTYPE>[EF]\Projects\CSharp Simple Distributed Application\CSharp Simple Distributed Application.etp</PROTOTYPE>
      <PROTOTYPE>[EF]\Projects\Visual Basic Simple Distributed Application\Visual Basic Simple Distributed Application.etp</PROTOTYPE>
   </PROTOTYPES>
   <ELEMENTSET>
      <DEFAULTACTION>EXCLUDE</DEFAULTACTION>
      <ORDER>INCLUDEEXCLUDE</ORDER>
      <INCLUDE>projBusinessFacade</INCLUDE>
      <INCLUDE>projWebService</INCLUDE>
      <INCLUDE>projBusinessRules</INCLUDE>
      <INCLUDE>projDataAccess</INCLUDE>
      <INCLUDE>projWebUI</INCLUDE>
      <INCLUDE>projWinUI</INCLUDE>
      <INCLUDE>projSystem</INCLUDE>
      <INCLUDE>projItemHTMLPage</INCLUDE>
      <INCLUDE>projCSharpProject</INCLUDE>
      <INCLUDE>projVBProject</INCLUDE>
      <INCLUDE>projCSharpEmptyProject</INCLUDE>
      <INCLUDE>projCSharpEmptyWeb</INCLUDE>
      <INCLUDE>projVBEmptyProject</INCLUDE>
      <INCLUDE>projVBEmptyWebProject</INCLUDE>
      <INCLUDE>projVCManagedCppEmptyProject</INCLUDE>
   </ELEMENTSET>
</ELEMENT>

Vea también

ID | CONTEXT | IDENTIFIERS | ELEMENTSET | CONSTRAINTS | PROTOTYPES | FEATURELINKS | Referencia de lenguaje de descripción de plantillas

  • Last updated on