Método VCConfiguration.BuildWithProperty
Começa uma compilação assíncrona com uma determinada propriedade definida para algum valor além do que está definido no arquivo de projeto.
Namespace: Microsoft.VisualStudio.VCProjectEngine
Assembly: Microsoft.VisualStudio.VCProjectEngine (em Microsoft.VisualStudio.VCProjectEngine.dll)
Sintaxe
'Declaração
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.bldActionTypesUm dos valores de enumeração que especifica o tipo de compilação para iniciar.
bstrPropertyName
Tipo: StringO nome de um MSBuild propriedade global para definir o projeto antes do início da compilação.
bstrPropertyValue
Tipo: StringUm valor para definir a propriedade representado pela bstrPropertyName parâmetro.
callback
Tipo: Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallbackUma função de retorno de chamada opcional que é chamada quando a compilação for concluída. Caso contrário, nulluma referência nula (Nothing no Visual Basic).
Exceções
Exceção | Condição |
---|---|
InvalidOperationException | Este método é chamado em um VCConfiguration o objeto que não esteja na configuração de solução ativa. - ou - Uma compilação já está em andamento. |
Comentários
A compilação que esteja na fila por esse método talvez não apareçam na fila de compilação do Gerenciador de construir a solução quando esse método é finalizado. Chamadores que devem aguardar a conclusão da compilação devem esperar em um thread de segundo plano até que a função de retorno de chamada é chamada. Essa tática evita um deadlock no thread principal, que deve bomba de mensagens para iniciar a compilação.
A função de retorno de chamada, se fornecido, é chamada assim isso VCConfiguration objeto termina o edifício, que pode ser antes de terminar de criar a solução. Isso pode acontecer, por exemplo, se outras criações também estão na fila. A função de retorno de chamada é invocada no thread principal.
A VCConfiguration objeto pode ser construído somente se ele estiver ativo considerando-se a configuração de solução ativa no momento.
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.