VCConfiguration.BuildWithProperty - метод
Начинает асинхронное построение, задавая указанному свойству значение, отличное от определенного в файле проекта.
Пространство имен: Microsoft.VisualStudio.VCProjectEngine
Сборка: Microsoft.VisualStudio.VCProjectEngine (в Microsoft.VisualStudio.VCProjectEngine.dll)
Синтаксис
'Декларация
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
)
Параметры
bldType
Тип: Microsoft.VisualStudio.VCProjectEngine.bldActionTypesОдно из значений перечисления, указывающее тип запускаемого построения.
bstrPropertyName
Тип: StringИмя глобального свойства MSBuild, которое требуется задать для проекта, прежде чем начинать построение.
bstrPropertyValue
Тип: StringЗначение, которое требуется задать свойству, представленному параметром bstrPropertyName.
callback
Тип: Microsoft.VisualStudio.VCProjectEngine.IVCBuildCompleteCallbackНеобязательная функция обратного вызова, вызываемая при завершении построения; в противном случае — значение nullссылка NULL (Nothing в Visual Basic).
Исключения
Исключение | Условие |
---|---|
InvalidOperationException | Этот метод вызывается для объекта VCConfiguration, который не входит в активную конфигурацию решения. – или – Построение уже выполняется. |
Заметки
Построение, которое очереди с помощью этого метода может не отображаться в очереди построений диспетчера построения решений, если этот метод не влияет. Вызывающие объекты должны находиться построения для выполнения должны находиться в фоновом потоке, пока функция обратного вызова не вызывается. Эта тактика избежать взаимоблокировки в главном потоке, которое должно отказать сообщениям для запуска построения.
Функция обратного вызова, если оно вызывается после того, как этот объект VCConfiguration завершения построения, который может быть до завершения построения решений. Это может произойти, например, если другие также построения в очереди. Функция обратного вызова вызывается с основным потоком.
Объект VCConfiguration может быть построена, только если они заданного активное в данный момент, — активной конфигурации решения.
Безопасность платформы .NET Framework
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Для получения дополнительной информации см. Использование библиотек из не вполне надежного кода.