M

IExternalCommand.Execute

Description:
Overload this method to implement and external command within Revit.

Result Execute(
	ExternalCommandData commandData,
	out string message,
	ElementSet elements
)

Function Execute ( 
	commandData As ExternalCommandData,
	<OutAttribute> ByRef message As String,
	<OutAttribute> elements As ElementSet
) As Result

Result Execute(
	ExternalCommandData^ commandData, 
	[InAttribute] [OutAttribute] String^% message, 
	[InAttribute] [OutAttribute] ElementSet^ elements
)

abstract Execute : 
        commandData : ExternalCommandData * 
        message : string byref * 
        elements : ElementSet byref -> Result

ExternalCommandData

commandData

An ExternalCommandData object which contains reference to Application and View needed by external command.
String%

message

Error message can be returned by external command. This will be displayed only if the command status was "Failed". There is a limit of 1023 characters for this message; strings longer than this will be truncated.
ElementSet

elements

Element set indicating problem elements to display in the failure dialog. This will be used only if the command status was "Failed".

Return Value Result The result indicates if the execution fails, succeeds, or was canceled by user. If it does not succeed, Revit will undo any changes made by the external command.