Namespace: Autodesk.Revit.DB Class: FilteredElementCollector

FilteredElementCollector.GetElementIterator

Method

Description:
Returns an element iterator to the elements passing the filters.

Remarks:
Calling this when you have an active iterator to this same collector will result in the first iterator being stopped by this call.

Syntax

public FilteredElementIterator GetElementIterator()

Public Function GetElementIterator As FilteredElementIterator

public:
FilteredElementIterator^ GetElementIterator()

member GetElementIterator : unit -> FilteredElementIterator

Examples

FilteredElementCollector collector = new FilteredElementCollector(document);

// Apply a filter to get all pipes in the document
collector.OfClass(typeof(Autodesk.Revit.DB.Plumbing.Pipe));

// Get results as an element iterator and look for a pipe with
// a specific flow state
FilteredElementIterator elemItr = collector.GetElementIterator();
elemItr.Reset();
while (elemItr.MoveNext())
{
    Pipe pipe = elemItr.Current as Pipe;
    if (pipe.FlowState == PipeFlowState.LaminarState)
    {
        TaskDialog.Show("Revit", "Model has at least one pipe with Laminar flow state.");
        break;
    }
}

Dim collector As New FilteredElementCollector(document)

' Apply a filter to get all pipes in the document
collector.OfClass(GetType(Autodesk.Revit.DB.Plumbing.Pipe))

' Get results as an element iterator and look for a pipe with
' a specific flow state
Dim elemItr As FilteredElementIterator = collector.GetElementIterator()
elemItr.Reset()
While elemItr.MoveNext()
   Dim pipe As Pipe = TryCast(elemItr.Current, Pipe)
   If pipe.FlowState = PipeFlowState.LaminarState Then
      TaskDialog.Show("Revit", "Model has at least one pipe with Laminar flow state.")
      Exit While
   End If
End While

Exceptions

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