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, _
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%]


Type: SystemString
Property name.
Type: SystemString
Property namespace.
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.