CreateExtendedAttribute

CreateExtendedAttribute()

Creates a new extended attribute with the field ID which equals to this object’s field ID value.

public ExtendedAttribute CreateExtendedAttribute()

Return Value

returns created instance of the ExtendedAttribute class with the fieldID which equals to this object’s fieldID value.

Examples

Shows how to create extended attributes.

var project = new Project(DataDir + "Blank2010.mpp");

var definition = project.ExtendedAttributes.GetById((int)ExtendedAttributeTask.Text1);

// If the Custom field doesn't exist in Project, create it
if (definition == null)
{
    definition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Text1, "My text field");
    project.ExtendedAttributes.Add(definition);
}

// Generate Extended Attribute from definition
var attribute = definition.CreateExtendedAttribute();
attribute.TextValue = "Text attribute value";

// Add extended attribute to task
var task = project.RootTask.Children.Add("Task 1");
task.ExtendedAttributes.Add(attribute);

project.Save(OutDir + "CreateExtendedAttributes_out.mpp", SaveFileFormat.Mpp);

See Also


CreateExtendedAttribute(string)

Creates a new extended attribute with the field ID which equals to this object’s field ID value and the specified text value.

public ExtendedAttribute CreateExtendedAttribute(string textValue)
ParameterTypeDescription
textValueStringThe specified text value.

Return Value

returns created instance of the ExtendedAttribute class with the fieldID which equals to this object’s fieldID value.

Exceptions

exceptioncondition
InvalidOperationExceptionIf current CfType is not ‘Text’

Examples

Shows how to create extended attribute definition and set a string value of the attribute while its constructing.

var project = new Project(DataDir + "Project2.mpp");

var definition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Text1, "My Text");
project.ExtendedAttributes.Add(definition);

var task = project.RootTask.Children.Add("Task");
task.Set(Tsk.Start, new DateTime(2020, 4, 22, 8, 0, 0));
task.Set(Tsk.Duration, project.GetDuration(1, TimeUnitType.Day));

// create extended attribute with a value equals to the 'Common Info'
var extendedAttribute = definition.CreateExtendedAttribute("Common Info");

// add extended attribute initialized by value the 'Common Info'
task.ExtendedAttributes.Add(extendedAttribute);

See Also


CreateExtendedAttribute(decimal)

Creates a new extended attribute with the field ID which equals to this object’s field ID value and the specified numeric value.

public ExtendedAttribute CreateExtendedAttribute(decimal numericValue)
ParameterTypeDescription
numericValueDecimalThe specified numeric value.

Return Value

returns created instance of the ExtendedAttribute class with the fieldID which equals to this object’s fieldID value.

Exceptions

exceptioncondition
InvalidOperationExceptionIf current CfType is not ‘Number’ or ‘Cost’

Examples

Shows how to create extended attribute definition and set a decimal value of the attribute while its constructing.

var project = new Project(DataDir + "Project2.mpp");

var definition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Cost1, "My Cost");
project.ExtendedAttributes.Add(definition);

var task = project.RootTask.Children.Add("Task");
task.Set(Tsk.Start, new DateTime(2020, 4, 22, 8, 0, 0));
task.Set(Tsk.Duration, project.GetDuration(1, TimeUnitType.Day));

// create extended attribute with a value equals to 999m 
var extendedAttribute = definition.CreateExtendedAttribute(999m);

// add extended attribute initialized by value 999m
task.ExtendedAttributes.Add(extendedAttribute);

See Also


CreateExtendedAttribute(DateTime)

Creates a new extended attribute with the field ID which equals to this object’s field ID value and the specified date value.

public ExtendedAttribute CreateExtendedAttribute(DateTime dateTimeValue)
ParameterTypeDescription
dateTimeValueDateTimeThe specified date time value.

Return Value

returns created instance of the ExtendedAttribute class with the fieldID which equals to this object’s fieldID value.

Exceptions

exceptioncondition
InvalidOperationExceptionIf current CfType is not ‘Date’, ‘Start’ or ‘Finish’

Examples

Shows how to create extended attribute definition and set a datetime value of the attribute while its constructing.

var project = new Project(DataDir + "Project2.mpp");

var definitionWithDate = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Date1, "My Date");
project.ExtendedAttributes.Add(definitionWithDate);

var task = project.RootTask.Children.Add("Task");
task.Set(Tsk.Start, new DateTime(2020, 4, 22, 8, 0, 0));
task.Set(Tsk.Duration, project.GetDuration(1, TimeUnitType.Day));

// create extended attribute with a value equals to DateTime.Now 
var extendedAttribute = definitionWithDate.CreateExtendedAttribute(DateTime.Now);

// add extended attribute
task.ExtendedAttributes.Add(extendedAttribute);

See Also


CreateExtendedAttribute(Duration)

Creates a new extended attribute with the field ID which equals to this object’s field ID value and the specified duration value.

public ExtendedAttribute CreateExtendedAttribute(Duration durationValue)
ParameterTypeDescription
durationValueDurationThe specified duration value.

Return Value

returns created instance of the ExtendedAttribute class with the fieldID which equals to this object’s fieldID value.

Exceptions

exceptioncondition
InvalidOperationExceptionIf current CfType is not ‘Duration’

Examples

Shows how to create extended attribute definition and set a duration while its constructing.

var project = new Project(DataDir + "Project2.mpp");
var task = project.RootTask.Children.Add("Test");
task.Set(Tsk.Start, new DateTime(2020, 4, 22, 8, 0, 0));
task.Set(Tsk.Duration, project.GetDuration(1, TimeUnitType.Day));

var definition = ExtendedAttributeDefinition.CreateTaskDefinition(ExtendedAttributeTask.Duration1, "Custom Duration");
project.ExtendedAttributes.Add(definition);

// extended attribute Duration1 = 2 days
var extendedAttribute = definition.CreateExtendedAttribute(project.GetDuration(2, TimeUnitType.Day));

// add extended attribute to the task
task.ExtendedAttributes.Add(extendedAttribute);

See Also


CreateExtendedAttribute(bool)

Creates a new extended attribute with the field ID which equals to this object’s field ID value and the specified flag value.

public ExtendedAttribute CreateExtendedAttribute(bool flagValue)
ParameterTypeDescription
flagValueBooleanThe specified flag value.

Return Value

returns created instance of the ExtendedAttribute class with the fieldID which equals to this object’s fieldID value.

Exceptions

exceptioncondition
InvalidOperationExceptionIf current CfType is not ‘Flag’

Examples

Shows how to create extended attribute definition and set a value of a flag while its constructing.

var project = new Project(DataDir + "Project2.mpp");

var resource = project.Resources.Add("Resource 1");
resource.Set(Rsc.Type, ResourceType.Cost);

// create a definition for a boolean custom field
var definition = ExtendedAttributeDefinition.CreateResourceDefinition(ExtendedAttributeResource.Flag7, "My Custom Flag");

// create an attribute and set the initial value to 'true'
var attribute = definition.CreateExtendedAttribute(true);
resource.ExtendedAttributes.Add(attribute);

See Also


CreateExtendedAttribute(Value)

Creates new extended attribute linked with specified Value item.

public ExtendedAttribute CreateExtendedAttribute(Value lookupValue)
ParameterTypeDescription
lookupValueValueThe specified Value item.

Return Value

returns created instance of the ExtendedAttribute class linked with specified Value item.

Remarks

lookupValue should be previously added to the ExtendedAttributeDefinition using AddLookupValue method.

Examples

Use this code to create new ExtendedAttribute using specific value:

taskTextAttr.AddLookupValue(value1);
taskTextAttr.AddLookupValue(value2);
var extendedAttribute = taskTextAttr.CreateExtendedAttribute(value2);

Shows how to create extended attribute definition and set a value while its constructing.

var project = new Project(DataDir + "Project2.mpp");

// Create a custom field definition based on the lookup table, which was declared above.
var customFieldDefinition = ExtendedAttributeDefinition.CreateLookupTaskDefinition(CustomFieldType.Number, ExtendedAttributeTask.Number10, "Status");

var value1 = new Value { Id = 1, Val = "25", Description = "Active" };
var value2 = new Value { Id = 2, Val = "12", Description = "Inactive" };
customFieldDefinition.AddLookupValue(value1);
customFieldDefinition.AddLookupValue(value2);
project.ExtendedAttributes.Add(customFieldDefinition);

var task = project.RootTask.Children.Add("Task");

// create extended attribute for a value 
var extendedAttribute = customFieldDefinition.CreateExtendedAttribute(value2);

// add extended attribute to the task
task.ExtendedAttributes.Add(extendedAttribute);

See Also