Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Interfaz VCCLCompilerTool

 

El objeto VCCLCompilerTool expone la funcionalidad de las opciones del compilador de C++. Vea Compiler Options para obtener más información sobre las opciones del compilador.

Espacio de nombres:   Microsoft.VisualStudio.VCProjectEngine
Ensamblado:  Microsoft.VisualStudio.VCProjectEngine (en Microsoft.VisualStudio.VCProjectEngine.dll)

[GuidAttribute("80B63513-3E87-44A5-8E12-4BA7F981153E")]
public interface VCCLCompilerTool

NombreDescripción
System_CAPS_pubpropertyAdditionalIncludeDirectories

Obtiene o establece uno o más directorios para agregar a la ruta de inclusión. AdditionalIncludeDirectories expone la funcionalidad de la opción /I (其他 Include 目錄) del compilador, la opción [全般] ([MIDL] プロパティ ページ) del compilador de MIDL, y la opción [リソース] プロパティ ページ del compilador de recursos.

System_CAPS_pubpropertyAdditionalOptions

Obtiene o establece opciones que se van a agregar al final de la línea de comandos inmediatamente antes del nombre o de los nombres de archivo.Un ejemplo de ello es si una opción no es compatible con el modelo de objetos.

System_CAPS_pubpropertyAdditionalUsingDirectories

Obtiene o establece un directorio de búsqueda para resolver las referencias a archivos que se transfieren a la directiva #using (Directiva) (C++). AdditionalUsingDirectories expone la funcionalidad de la opción /AI (Meta Veri Dizinlerini Belirt) del compilador.

System_CAPS_pubpropertyAssemblerListingLocation

Obtiene o establece la ruta de acceso relativa y/o nombre de un archivo de listas de ASM. AssemblerListingLocation expone la funcionalidad de la opción del compilador.

System_CAPS_pubpropertyAssemblerOutput

Obtiene o establece el contenido del archivo de salida del lenguaje de ensamblado. AssemblerOutput expone la funcionalidad de las opciones /FA, /Fa(목록 파일) del compilador.

System_CAPS_pubpropertyBasicRuntimeChecks

Obtiene o establece un valor para indicar si se van a realizar comprobaciones completas de errores en tiempo de ejecución /RTC (Run-Time Error Checks)), si se va a comprobar la validez del marco de pila en tiempo de ejecución (/RTC (Run-Time Error Checks)) y si se van a comprobar las variables no inicializadas en tiempo de ejecución (/RTC (Run-Time Error Checks)).

System_CAPS_pubpropertyBrowseInformation

Especifica el nivel de en el archivo .bsc. BrowseInformation expone la funcionalidad de las opciones /FR, /Fr (SBR-Datei erstellen) del compilador.

System_CAPS_pubpropertyBrowseInformationFile

Obtiene o establece el nombre opcional para el archivo de información del explorador. BrowseInformationFile expone la funcionalidad de las opciones /FR, /Fr (Create .Sbr File) del compilador.

System_CAPS_pubpropertyBufferSecurityCheck

Obtiene o establece un valor que indica si se van a comprobar las saturaciones de búfer. BufferSecurityCheck expone la funcionalidad de la opción /GS (verificação de segurança do buffer) del compilador.

System_CAPS_pubpropertyCallingConvention

Obtiene o establece la convención de llamada predeterminada de la aplicación. CallingConvention expone la funcionalidad de las opciones /Gd、/Gr、/Gv、/Gz (呼び出し規約) del compilador.

System_CAPS_pubpropertyCompileAs

Selecciona la opción de lenguaje de compilación para los archivos .C y .CPP. CompileAs expone la funcionalidad de las opciones /Tc, /Tp, /TC, /TP (Określ typ pliku źródłowego) del compilador.

System_CAPS_pubpropertyCompileAsManaged

Obtiene o establece un valor que indica las opciones del compilador.

System_CAPS_pubpropertyCompileOnly

Obtiene o establece un valor que indica si se va a compilar sin vinculación.

System_CAPS_pubpropertyDebugInformationFormat

Obtiene o establece el tipo de información de depuración generada por el compilador. DebugInformationFormat expone la funcionalidad de las opciones /Z7, /Zi, /ZI (Debuginformationsformat) del compilador.

System_CAPS_pubpropertyDefaultCharIsUnsigned

Obtiene o establece el tipo de carácter predeterminado que se va a firmar. DefaultCharIsUnsigned expone la funcionalidad de la opción /J (Varsayılan Karakter Türü İmzasız) del compilador.

System_CAPS_pubpropertyDetect64BitPortabilityProblems

Obtiene o establece un valor que indica si el compilador comprobará si hay problemas de portabilidad de 64 bits. Detect64BitPortabilityProblems expone la funcionalidad de la opción /Wp64 (Rileva errori di portabilità a 64 bit) del compilador.

System_CAPS_pubpropertyDisableLanguageExtensions

Obtiene o establece un valor que indica si se van a suprimir las extensiones de lenguaje. DisableLanguageExtensions expone la funcionalidad de la opción /Za, /Ze (Deshabilitar extensiones de lenguaje) del compilador.

System_CAPS_pubpropertyDisableSpecificWarnings

Obtiene o establece un valor que deshabilita los números de advertencia deseados; coloca los números en una lista delimitada por punto y coma. DisableSpecificWarnings expone la funcionalidad de la opción /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, /won (Warning Level) del compilador.

System_CAPS_pubpropertyEnableEnhancedInstructionSet

Obtiene o establece un valor que permite el uso de instrucciones situadas en procesadores que admiten conjuntos de instrucciones mejorados, como las mejoras de SSE y SSE2 a IA-32. EnableEnhancedInstructionSet expone la funcionalidad de la opción /ARCH del compilador.

System_CAPS_pubpropertyEnableFiberSafeOptimizations

Obtiene o establece un valor que permite optimizar el espacio de memoria cuando se usa fibra y acceso de almacenamiento local para los subprocesos. EnableFiberSafeOptimizations expone la funcionalidad de la opción /GT (Admitir el almacenamiento local de subprocesos para fibra) del compilador.

System_CAPS_pubpropertyEnableFunctionLevelLinking

Obtiene o establece un valor que habilita la vinculación en el nivel de función. EnableFunctionLevelLinking expone la funcionalidad de la opción /Gy (включение компоновки на уровне функций) del compilador.

System_CAPS_pubpropertyEnableIntrinsicFunctions

Obtiene o establece un valor que indica si se van a usar funciones intrínsecas para generar código más rápido, pero posiblemente de mayor tamaño. EnableIntrinsicFunctions expone la funcionalidad de la opción /Oi (產生內建函式) del compilador.

System_CAPS_pubpropertyEnablePREfast

Obtiene o establece si el análisis de código nativo está habilitado.

System_CAPS_pubpropertyErrorReporting

Obtiene o establece los informes de errores del compilador.

System_CAPS_pubpropertyExceptionHandling

Obtiene o establece un valor usado para las llamadas a destructores para objetos automáticos durante un desenredo de pila debido a una excepción producida. ExceptionHandling expone la funcionalidad de la opción /EH (Modelo de control de excepciones) del compilador.

System_CAPS_pubpropertyExecutionBucket

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Solo para uso interno de Microsoft.

System_CAPS_pubpropertyExpandAttributedSource

Obtiene o establece un valor que indica si se ha de crear un archivo de lista con los atributos expandidos insertados en el archivo de código fuente. ExpandAttributedSource expone la funcionalidad de la opción /Fx (Merge Injected Code) del compilador.

System_CAPS_pubpropertyFavorSizeOrSpeed

Obtiene o establece un valor que indica si se va a favorecer el tamaño o la velocidad del código. FavorSizeOrSpeed expone la funcionalidad de las opciones /Os, /Ot (Ottimizza per dimensione codice, Ottimizza per velocità codice) del compilador.

System_CAPS_pubpropertyFloatingPointExceptions

Establece u obtiene si está habilitado el control de excepciones de punto flotante definido por el usuario.

System_CAPS_pubpropertyfloatingPointModel

Establece u obtiene el modelo de punto flotante.

System_CAPS_pubpropertyForceConformanceInForLoopScope

Obtiene o establece un valor que indica si se va a forzar el compilador para cumplir con el ámbito local en un bucle For. ForceConformanceInForLoopScope expone la funcionalidad de la opción /Zc:forScope (Forzar ajuste en el ámbito del bucle For) del compilador.

System_CAPS_pubpropertyForcedIncludeFiles

Obtiene o establece un valor que especifica uno o más archivos de inclusión forzada. ForcedIncludeFiles expone la funcionalidad de la opción /FI (Dar nombre al archivo de inclusión obligatorio) del compilador.

System_CAPS_pubpropertyForcedUsingFiles

Fuerza el uso de un nombre de archivo, como si se hubiera transferido a la directiva #using Directive (C++). ForcedUsingFiles expone la funcionalidad de la opción /FU (Name Forced #using File) del compilador.

System_CAPS_pubpropertyFullIncludePath

Obtiene una lista de todos los directorios incluidos en la compilación; es una concatenación de los directorios especificados con /I y los directorios especificados en el cuadro de diálogo VC++ Directories.También se evaluarán las macros presentes en estos directorios.

System_CAPS_pubpropertyGeneratePreprocessedFile

Obtiene o establece la opción de preprocesamiento para esta configuración. GeneratePreprocessedFile expone la funcionalidad de las opciones /EP (Wstępnie przetwórz do stdout bez dyrektyw #line) y /P (Preprocess to a File) del compilador.

System_CAPS_pubpropertyGenerateXMLDocumentationFiles

Establece u obtiene si se van a generar archivos de documentación XML.

System_CAPS_pubpropertyIgnoreStandardIncludePath

Obtiene o establece un valor que indica si se va a omitir la ruta de inclusión estándar. IgnoreStandardIncludePath expone la funcionalidad de la opción /X(忽略标准包含路径) del compilador, la opción [全般] ([MIDL] プロパティ ページ) del compilador de MIDL, y la opción [リソース] プロパティ ページ del compilador de recursos.

System_CAPS_pubpropertyInlineFunctionExpansion

Obtiene o establece el nivel de expansión de la función insertada para la compilación. InlineFunctionExpansion expone la funcionalidad de las opciones /Ob (関数のインライン展開) del compilador.

System_CAPS_pubpropertyKeepComments

Obtiene o establece un valor que indica si se va a suprimir la franja de comentarios del código fuente. KeepComments expone la funcionalidad de la opción /C (Preserve Comments During Preprocessing) del compilador.

System_CAPS_pubpropertyMinimalRebuild

Obtiene o establece un valor que indica si se van a detectar los cambios en las definiciones de clase de C++ y se van a volver a compilar los archivos de código fuente afectados. MinimalRebuild expone la funcionalidad de la opción /Gm (Povolit minimální opětovné sestavení) del compilador.

System_CAPS_pubpropertyObjectFile

Obtiene o establece un nombre para invalidar el nombre del archivo objeto predeterminado. ObjectFile expone la funcionalidad de la opción /Fo (Object File Name) del compilador.

System_CAPS_pubpropertyOmitDefaultLibName

Obtiene o establece si se omite el nombre de biblioteca predeterminado.

System_CAPS_pubpropertyOmitFramePointers

Obtiene o establece un valor que indica si se van a suprimir los punteros de marcos. OmitFramePointers expone la funcionalidad de la opción /Oy(프레임 포인터 생략) del compilador.

System_CAPS_pubpropertyOpenMP

Obtiene o establece si OpenMP está habilitado.

System_CAPS_pubpropertyOptimization

Obtiene o establece las opciones para la optimización. Optimization expone la funcionalidad de las opciones /Od (Disabilita (Debug)), /O1, /O2 (минимизировать размер, максимизировать скорость) y /Ox (Full Optimization) del compilador.

System_CAPS_pubpropertyPrecompiledHeaderFile

Obtiene o establece la ruta de acceso y/o nombre del archivo de encabezado precompilado generado. PrecompiledHeaderFile expone la funcionalidad de la opción /Fp (nomear arquivo .Pch) del compilador.

System_CAPS_pubpropertyPrecompiledHeaderThrough

Obtiene o establece el archivo de encabezado que se va a usar al crear o usar un archivo de encabezado precompilado. PrecompiledHeaderThrough expone la funcionalidad de las opciones /Yc(미리 컴파일된 헤더 파일 만들기) y /Yu (使用先行編譯標頭檔) del compilador.

System_CAPS_pubpropertyPreprocessorDefinitions

Obtiene o establece una o más definiciones del preprocesador. PreprocessorDefinitions expone la funcionalidad de la opción /D (Preprocessor Definitions) del compilador, la opción Páginas de propiedades MIDL: General del compilador de MIDL, y la opción Resources Property Pages del compilador de recursos.

System_CAPS_pubpropertyProgramDataBaseFileName

Obtiene o establece un nombre para un archivo .pdb generado por el compilador y nombre base para el archivo .idb necesario generado por el compilador. ProgramDataBaseFileName expone la funcionalidad de la opción /Fd (Program Database File Name) del compilador.

System_CAPS_pubpropertyRuntimeLibrary

Obtiene o establece la biblioteca de tiempo de ejecución para los vínculos. RuntimeLibrary expone la funcionalidad de las opciones /MD, /MT, /LD (Use Run-Time Library) del compilador.

System_CAPS_pubpropertyRuntimeTypeInfo

Obtiene o establece un valor que indica si se va a agregar código para comprobar los tipos de objeto de C++ en tiempo de ejecución (información de tipo en tiempo de ejecución). RuntimeTypeInfo expone la funcionalidad de la opción /GR (Habilitar la información de tipo en tiempo de ejecución) del compilador.

System_CAPS_pubpropertyShowIncludes

Obtiene o establece un valor que indica si se va a generar una lista de archivos de inclusión con la salida del compilador. ShowIncludes expone la funcionalidad de la opción /showIncludes(포함 파일 나열) del compilador.

System_CAPS_pubpropertySmallerTypeCheck

Obtiene o establece un valor que indica si se ha de permitir la comprobación para la conversión a tipos más pequeños. SmallerTypeCheck expone la funcionalidad de la opción /RTC(런타임 오류 검사) del compilador.

System_CAPS_pubpropertyStringPooling

Obtiene o establece un valor que indica si se va a habilitar la agrupación de cadenas de solo lectura para generar código compilado de menor tamaño. StringPooling expone la funcionalidad de la opción /GF (Eliminate Duplicate Strings) del compilador.

System_CAPS_pubpropertyStructMemberAlignment

Especifica los límites de 1, 2, 4, 8 o 16 bytes para la alineación de los miembros de struct. StructMemberAlignment expone la funcionalidad de la opción /Zp (Struct Member Alignment) del compilador de C++ y la opción MIDL Property Pages: Advanced del compilador de MIDL.

System_CAPS_pubpropertySuppressStartupBanner

Suprime la presentación de la pancarta de inicio y los mensajes de información.

System_CAPS_pubpropertyToolKind

Obtiene el nombre del tipo de herramienta.

System_CAPS_pubpropertytoolName

Obtiene el nombre de la herramienta especificada.

System_CAPS_pubpropertyToolPath

Obtiene la ruta de acceso a la herramienta especificada.

System_CAPS_pubpropertyTreatWChar_tAsBuiltInType

Obtiene o establece un valor que indica si wchar_t se va a tratar como un tipo integrado. TreatWChar_tAsBuiltInType expone la funcionalidad de la opción /Zc:wchar_t (wchar_t Is Native Type) del compilador.

System_CAPS_pubpropertyUndefineAllPreprocessorDefinitions

Obtiene o establece un valor que indica si no se van a definir todos los valores de preprocesador definidos previamente. UndefineAllPreprocessorDefinitions expone la funcionalidad de la opción /U, /u (Undefine Symbols) del compilador.

System_CAPS_pubpropertyUndefinePreprocessorDefinitions

Obtiene o establece un valor que especifica una o más definiciones del preprocesador. UndefinePreprocessorDefinitions expone la funcionalidad de la opción /U, /u (Undefine Symbols) del compilador de C++ y la opción MIDL Property Pages: Advanced del compilador de MIDL.

System_CAPS_pubpropertyUseFullPaths

Obtiene o establece si se van a usar rutas de acceso completas.

System_CAPS_pubpropertyUsePrecompiledHeader

Obtiene o establece un valor que habilita la creación o el uso de un encabezado precompilado durante la compilación. UsePrecompiledHeader expone la funcionalidad de las opciones /Yc (Crear archivo de encabezado precompilado) y /Yu (Use Precompiled Header File) del compilador.

System_CAPS_pubpropertyUseUnicodeResponseFiles

Designa si el compilador usa archivos de respuesta Unicode o no.

System_CAPS_pubpropertyVCProjectEngine

Obtiene un puntero al motor de proyecto.

System_CAPS_pubpropertyWarnAsError

Obtiene o establece un valor que indica si se habilita el compilador para tratar todas las advertencias como errores. WarnAsError expone la funcionalidad de la opción /w、/Wn、/WX、/Wall、/wln、/wdn、/wen、/won (警告レベル) del compilador de C++ y la opción MIDL Property Pages: General del compilador de MIDL.

System_CAPS_pubpropertyWarningLevel

Obtiene o establece un valor que representa lo estricto que debe ser el compilador a la hora de comprobar posibles construcciones sospechosas. WarningLevel expone la funcionalidad de la opción /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, /won (Warning Level) del compilador de C++ y la opción /w, /Wn, /WX, /Wall, /wln, /wdn, /wen, /won (Warning Level) del compilador de MIDL.

System_CAPS_pubpropertyWholeProgramOptimization

Obtiene o establece un valor que indica si se van a habilitar las optimizaciones entre módulos mientras se retrasa la generación de código al tiempo de vinculación. WholeProgramOptimization expone la funcionalidad de la opción /GL (Ottimizzazione intero programma) del compilador.

System_CAPS_pubpropertyXMLDocumentationFileName

Obtiene o establece el nombre del archivo de documentación XML.

NombreDescripción
System_CAPS_pubmethodget_PropertyOption(String, Int32)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Solo para uso interno de Microsoft.

The following example demonstrates how to use the EnablePREfast and AdditionalOptions properties to set the /analyze:WX- switch. (Both properties are required to do this.) Specifying /analyze:WX- means that code analysis warnings will not be treated as errors when compiling with /WX. Para obtener más información, consulta /analyze(코드 분석).

// Add references to Microsoft.VisualStudio.VCProjectEngine and 
// System.Windows.Forms.
using System;
using Extensibility;
using EnvDTE;
using EnvDTE80;
using Microsoft.VisualStudio.VCProjectEngine;
using System.Text;
using System.Windows.Forms;

public void EnablePREfastExample(DTE2 dte)
{
    try
    {
        VCProject prj;
        IVCCollection cfgs, tools;
        VCConfiguration cfg;
        VCCLCompilerTool tool;
        StringBuilder sb = new StringBuilder();

        prj = (Microsoft.VisualStudio.VCProjectEngine.VCProject)
          dte.Solution.Projects.Item(1).Object;
        cfgs = 
          (Microsoft.VisualStudio.VCProjectEngine.IVCCollection)
          prj.Configurations;
        cfg = 
          (Microsoft.VisualStudio.VCProjectEngine.VCConfiguration)
           cfgs.Item(1);
        tools = 
          (Microsoft.VisualStudio.VCProjectEngine.IVCCollection)
          cfg.Tools;
        tool = 
          (Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool)
          tools.Item("VCCLCompilerTool");

        sb.Length = 0;
        sb.Append("Current project PREfast setting: " +
          tool.EnablePREfast + Environment.NewLine);
        sb.Append("Flag: " + tool.AdditionalOptions);
        MessageBox.Show(sb.ToString());

        // Toggle PREfast setting.
        if (!(tool.EnablePREfast == true))
        {
            // PREfast is not enabled. Turn it and the WX- flag on.
            tool.EnablePREfast = true;
            tool.AdditionalOptions = "/analyze:WX-";
        }
        else
        {
            // Toggle the opposite.
            tool.EnablePREfast = false;
            tool.AdditionalOptions = "/analyze:WX";
        }
        sb.Length = 0;
        sb.Append("New project PREfast setting: " +
          tool.EnablePREfast + Environment.NewLine);
        sb.Append("Flag: " + tool.AdditionalOptions);
        MessageBox.Show(sb.ToString());
    }
    catch (System.Exception errmsg)
    {
        MessageBox.Show("ERROR! " + errmsg.Message);
    }
}
Volver al principio
Mostrar: