Namespace: Autodesk.Revit.DB Class: GlobalParameter

GlobalParameter.Create

Method

Description:
Creates a new Global Parameter in the given document.

Remarks:
Global parameters may be created only in Project documents, not in families.

Each global parameter must have a valid name that is unique within the document. To test whether a name is unique, use the IsUniqueName(Document, String) method.

While global parameters can be created with almost any type of data, there is a few types that are not currently supported, such as the ElementId type. Programmers can test whether a particular data type is appropriate for a global parameter by using the [!:SpecUtils.IsSpec(ForgeTypeId)] method.

Parameters are created as non-reporting initially, but programmers are free to modify the IsReporting property once a global parameter is created and happens to be of a type eligible for reporting.

Syntax

public static GlobalParameter Create(
	Document document,
	string name,
	ForgeTypeId specTypeId
)

Public Shared Function Create ( 
	document As Document,
	name As String,
	specTypeId As ForgeTypeId
) As GlobalParameter

public:
static GlobalParameter^ Create(
	Document^ document, 
	String^ name, 
	ForgeTypeId^ specTypeId
)

static member Create : 
        document : Document * 
        name : string * 
        specTypeId : ForgeTypeId -> GlobalParameter

Parameters

Parameter	Type	Description
document	Document	Document in which the new parameter is to be created
name	String	The name of the new parameter. It must be unique in the document
specTypeId	ForgeTypeId	Identifier of the spec describing the parameter's data type.

Return Value

Type	Description
GlobalParameter	An instance of the new global parameter

Exceptions

Exception	Condition
ArgumentException	Global parameters are not supported in the given document. A possible cause is that it is not a project document, for global parameters are not supported in Revit families. -or- name is an empty string. -or- name cannot include prohibited characters, such as "{, }, [, ], \|, ;, less-than sign, greater-than sign, ?, `, ~". -or- A global parameter with the given name already exists in the document. -or- specTypeId is not a spec identifier.
ArgumentNullException	A non-optional argument was null

Exception

Condition

ArgumentException

Global parameters are not supported in the given document. A possible cause is that it is not a project document, for global parameters are not supported in Revit families. -or- name is an empty string. -or- name cannot include prohibited characters, such as "{, }, [, ], |, ;, less-than sign, greater-than sign, ?, `, ~". -or- A global parameter with the given name already exists in the document. -or- specTypeId is not a spec identifier.

ArgumentNullException

A non-optional argument was null