M

FailureDefinition.CreateFailureDefinition

Description:
Creates an instance of a FailureDefinition.

Remarks:
The newly created FailureDefinition will be added to the FailureDefinitionRegistry. Because FailureDefinition could only be registered when Revit starting up, this function cannot be used after Revit has already started. Throws InvalidOperationException if invoked after Revit start-up is completed.

public static FailureDefinition CreateFailureDefinition(
	FailureDefinitionId id,
	FailureSeverity severity,
	string messageString
)

Public Shared Function CreateFailureDefinition ( 
	id As FailureDefinitionId,
	severity As FailureSeverity,
	messageString As String
) As FailureDefinition

public:
static FailureDefinition^ CreateFailureDefinition(
	FailureDefinitionId^ id, 
	FailureSeverity severity, 
	String^ messageString
)

static member CreateFailureDefinition : 
        id : FailureDefinitionId * 
        severity : FailureSeverity * 
        messageString : string -> FailureDefinition

FailureDefinitionId

id

Unique identifier of the failure.
FailureSeverity

severity

The severity of the failure. Cannot be FailureSeverity::None.
String

messageString

A user-visible string describing the failure.

Return Value FailureDefinition The created FailureDefinition instance.

ArgumentException

The id of failure definition is not valid. -or- The id of failure definition is already used to register another FailureDefinition. -or- The severity of failures cannot be FailureSeverity::None. -or- Message string is empty or contains invalid characters.
ArgumentNullException

A non-optional argument was null
ArgumentOutOfRangeException

A value passed for an enumeration argument is not a member of that enumeration