Filtered Element Collector First Element Method

Returns the first element to pass the filter(s).

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 25.3.0.0 (25.3.0.0)

Syntax

public Element FirstElement()

Public Function FirstElement As Element

public:
Element^ FirstElement()

member FirstElement : unit -> Element

Return Value

Element
The first element.

Exceptions

Exception	Condition
InvalidOperationException	The collector does not have a filter applied. Extraction or iteration of elements is not permitted without a filter.

Remarks

This will reset the collector to the beginning and find the first element that passes the applied filter(s). If you have an active iterator to this same collector it will be stopped by this call.

Reference

FilteredElementCollector Class

Autodesk.Revit.DB Namespace

FirstElement Method

Filtered Element Collector First Element Method

Return Value

Reference

Put AI to work inside Revit.