Creates a new material.
Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 25.3.0.0 (25.3.0.0)
Syntax
C#
public static ElementId Create( Document document, string name )
Parameters
- document Document
- The document in which to create the material.
- name String
- The name of the new material.
Return Value
ElementIdIdentifier of the new material.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | name cannot include prohibited characters, such as "{, }, [, ], |, ;, less-than sign, greater-than sign, ?, `, ~". -or- The given value for name is already in use as a material element name. |
| ArgumentNullException | A non-optional argument was null |
Example
C#
//Create the material ElementId materialId = Material.Create(document, "My Material"); Material material = document.GetElement(materialId) as Material; //Create a new property set that can be used by this material StructuralAsset strucAsset = new StructuralAsset("My Property Set", StructuralAssetClass.Concrete); strucAsset.Behavior = StructuralBehavior.Isotropic; strucAsset.Density = 232.0; //Assign the property set to the material. PropertySetElement pse = PropertySetElement.Create(document, strucAsset); material.SetMaterialAspectByPropertySet(MaterialAspect.Structural, pse.Id);
VB
'Create the material Dim materialId As ElementId = Material.Create(document, "My Material") Dim material__1 As Material = TryCast(document.GetElement(materialId), Material) 'Create a new property set that can be used by this material Dim strucAsset As New StructuralAsset("My Property Set", StructuralAssetClass.Concrete) strucAsset.Behavior = StructuralBehavior.Isotropic strucAsset.Density = 232.0 'Assign the property set to the material. Dim pse As PropertySetElement = PropertySetElement.Create(document, strucAsset) material__1.SetMaterialAspectByPropertySet(MaterialAspect.Structural, pse.Id)