VCConfiguration.BuildWithProperty (Método)
Inicia una compilación asincrónica con una propiedad dada establecida en algún valor más allá de lo definido en el archivo de proyecto.
Espacio de nombres: Microsoft.VisualStudio.VCProjectEngine
Ensamblado: Microsoft.VisualStudio.VCProjectEngine (en Microsoft.VisualStudio.VCProjectEngine.dll)
Sintaxis
'Declaración
Sub BuildWithProperty ( _
bldType As bldActionTypes, _
bstrPropertyName As String, _
bstrPropertyValue As String, _
callback As IVCBuildCompleteCallback _
)
void BuildWithProperty(
bldActionTypes bldType,
string bstrPropertyName,
string bstrPropertyValue,
IVCBuildCompleteCallback callback
)
void BuildWithProperty(
[InAttribute] bldActionTypes bldType,
[InAttribute] String^ bstrPropertyName,
[InAttribute] String^ bstrPropertyValue,
[InAttribute] IVCBuildCompleteCallback^ callback
)
abstract BuildWithProperty :
bldType:bldActionTypes *
bstrPropertyName:string *
bstrPropertyValue:string *
callback:IVCBuildCompleteCallback -> unit
function BuildWithProperty(
bldType : bldActionTypes,
bstrPropertyName : String,
bstrPropertyValue : String,
callback : IVCBuildCompleteCallback
)
Parámetros
- bldType
Tipo: Microsoft.VisualStudio.VCProjectEngine.bldActionTypes
Uno de los valores de enumeración que especifica el tipo de compilación que se va a iniciar.
- bstrPropertyName
Tipo: System.String
Nombre de una propiedad global de MSBuild que se va a establecer en el proyecto antes de que la compilación se inicie.
- bstrPropertyValue
Tipo: System.String
Valor en el que se va a establecer la propiedad representada por el parámetro bstrPropertyName.
- callback
Tipo: Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallback
Función de devolución de llamada opcional que se invoca cuando la compilación finaliza; de lo contrario, es nullreferencia null (Nothing en Visual Basic).
Excepciones
| Excepción | Condición |
|---|---|
| InvalidOperationException | Este método se invoca en un objeto de VCConfiguration que no está en la configuración de soluciones activa. O bien Una compilación ya está en curso. |
Comentarios
La compilación que se pone en cola con este método no puede aparecer en la cola de compilación de administrador de compilación de la solución cuando este método devuelve.Los llamadores que deben esperar la compilación para completar deben esperar en un subproceso de fondo hasta que se llame a la función de devolución de llamada.Esta táctica evita un interbloqueo en el subproceso principal, que debe suministrar mensajes para iniciar la compilación.
La función de devolución de llamada en el caso se denomina tan pronto como este objeto de VCConfiguration termine de compilar, que puede ser antes de la compilación de la solución finalice.Esto puede ocurrir, por ejemplo, si otras compilaciones también se ponen en la cola.la función de devolución de llamada se invoca en el subproceso principal.
Un objeto de VCConfiguration puede ser únicamente si se da activas actualmente configuración activa compilada de la solución.
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.