IBaseMessageContextPromote Method

Promotes the property into the message context.

Namespace:   Microsoft.BizTalk.Message.Interop
Assembly:  Microsoft.BizTalk.Pipeline (in Microsoft.BizTalk.Pipeline.dll)
Sub Promote ( _
	strName As [%$TOPIC/aa957547_en-us_BTS_80_1_0_0_0_0%], _
	strNameSpace As [%$TOPIC/aa957547_en-us_BTS_80_1_0_0_0_1%], _
	obj As [%$TOPIC/aa957547_en-us_BTS_80_1_0_0_0_2%] _
)
Dim instance As [%$TOPIC/aa957547_en-us_BTS_80_1_0_1_0_0%] 
Dim strName As [%$TOPIC/aa957547_en-us_BTS_80_1_0_1_0_1%] 
Dim strNameSpace As [%$TOPIC/aa957547_en-us_BTS_80_1_0_1_0_2%] 
Dim obj As [%$TOPIC/aa957547_en-us_BTS_80_1_0_1_0_3%]

instance.Promote(strName, strNameSpace, _
	obj)
void Promote(
	[%$TOPIC/aa957547_en-us_BTS_80_1_0_2_0_0%] strName,
	[%$TOPIC/aa957547_en-us_BTS_80_1_0_2_0_1%] strNameSpace,
	[%$TOPIC/aa957547_en-us_BTS_80_1_0_2_0_2%] obj
)
void Promote(
	[%$TOPIC/aa957547_en-us_BTS_80_1_0_3_0_0%]^ strName, 
	[%$TOPIC/aa957547_en-us_BTS_80_1_0_3_0_1%]^ strNameSpace, 
	[%$TOPIC/aa957547_en-us_BTS_80_1_0_3_0_2%]^ obj
)
abstract Promote : 
        strName:[%$TOPIC/aa957547_en-us_BTS_80_1_0_4_0_0%] * 
        strNameSpace:[%$TOPIC/aa957547_en-us_BTS_80_1_0_4_0_1%] * 
        obj:[%$TOPIC/aa957547_en-us_BTS_80_1_0_4_0_2%] -> unit
function Promote(
	strName : [%$TOPIC/aa957547_en-us_BTS_80_1_0_5_0_0%], 
	strNameSpace : [%$TOPIC/aa957547_en-us_BTS_80_1_0_5_0_1%], 
	obj : [%$TOPIC/aa957547_en-us_BTS_80_1_0_5_0_2%]
)

Parameters

strName
Type: SystemString
Property name.
strNameSpace
Type: SystemString
Property namespace.
obj
Type: SystemObject
Context property value.

When the message is published, the promoted properties are extracted from the context and written to the database as clear values. All the promoted properties for a message are used for subscription evaluation. The size of the promoted property cannot exceed 256 characters.

Properties promoted by the Promote method can be used when the port or orchestration is subscribed to the messages. If the types of the promoted properties do not match the values specified in subscription, the comparison fails and the message subscription does not occur.