component pragma

Controla la recopilación de información de examen o información de dependencia en los archivos de código fuente.

Sintaxis

#pragma component( browser, { on | off } [ ,references [ ,name ] ] )
#pragma component( minrebuild, { on | off } )
#pragma component( mintypeinfo, { on | off } )

Comentarios

Explorador

Puede activar o desactivar la recopilación, así como especificar que determinados nombres se omitan al recopilar la información.

El uso de on u off controla la recopilación de información de examen de la pragma hacia delante. Por ejemplo:

#pragma component(browser, off)

detiene la recopilación de información de examen por parte del compilador.

Nota:

Para activar la recopilación de información de examen con esta pragma, debe estar habilitada la información de examen.

La opción references se puede utilizar con o sin el argumento name. El uso de references sin name activa o desactiva la recopilación de referencias (sin embargo, continúa la recopilación de otra información de examen). Por ejemplo:

#pragma component(browser, off, references)

detiene la recopilación de información de referencia por parte del compilador.

El uso de references con name y off impide que aparezcan referencias a name en la ventana de información de examen. Utilice esta sintaxis para omitir nombres y tipos en los que no esté interesado y reducir el tamaño de los archivos de información de examen. Por ejemplo:

#pragma component(browser, off, references, DWORD)

omite referencias a DWORD desde ese punto en adelante. Puede volver a activar la recopilación de referencias a DWORD mediante on:

#pragma component(browser, on, references, DWORD)

Este es el único medio para reanudar la recopilación de referencias a name; debe activar explícitamente cualquier argumento name que haya desactivado.

Para evitar que el preprocesador expanda name (por ejemplo, que expanda NULL a 0), inclúyalo entre comillas:

#pragma component(browser, off, references, "NULL")

Recompilación mínima

La característica /Gm (Habilitar recompilación mínima) requiere que el compilador cree y almacene la información de dependencia de clase de C++, que ocupa espacio en disco. Para ahorrar espacio en disco, puede utilizar #pragma component( minrebuild, off ) siempre que no necesite recopilar información de dependencia, por ejemplo, en archivos de encabezado inalterados. Para volver a activar la recopilación de información de dependencia, debe insertar #pragma component( minrebuild, on ) después de las clases inalteradas.

Reducción de la información de tipo

La opción mintypeinfo reduce la información de depuración para la región especificada. El volumen de esta información es considerable, afectando a los archivos .pdb y .obj. No puede depurar clases ni estructuras en la región correspondiente a mintypeinfo. El uso de la opción mintypeinfo puede ser útil para evitar la advertencia siguiente:

LINK : warning LNK4018: too many type indexes in PDB "filename", discarding subsequent type information

Para más información, consulte la opción del compilador /Gm (Habilitar recompilación mínima).

Consulte también

Directivas pragma y las palabras clave __pragma y _Pragma