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.bldActionTypes
Um dos valores de enumeração que especifica o tipo de compilação para iniciar.
- bstrPropertyName
Tipo: System.String
O nome de um MSBuild propriedade global para definir o projeto antes do início da compilação.
- bstrPropertyValue
Tipo: System.String
Um valor para definir a propriedade representado pela bstrPropertyName parâmetro.
- callback
Tipo: Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallback
Uma 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áveis.