Autodesk.Revit.DB.FilterStringEquals

概述

Autodesk.Revit.DB.FilterStringEquals是Revit API中的一种过滤器，用于筛选出指定属性值等于特定字符串的元素。

语法

public static FilterStringEquals FilterStringEquals(
    BuiltInParameter parameterId,
    string value
)

参数

• parameterId：必需，用于指定要过滤的属性的BuiltInParameter枚举值。
• value：必需，用于指定要筛选元素的属性值字符串。

返回值

返回的是FilterElement对象，可作为FilteredElementCollector的参数使用。

示例

// 筛选出所有名称为“Wall-01”的墙体
FilteredElementCollector collector = new FilteredElementCollector(doc);
ElementFilter filter = FilterStringEquals.BuiltInParameter(
    BuiltInParameter.ALL_MODEL_TYPE_NAME, "Wall-01");
IList<Element> elements = collector.WherePasses(filter).ToElements();

注意事项

• 传入的value值大小写敏感。
• 可以通过多次创建FilterStringEquals实例，进行多条件筛选。
• 过滤器的执行效率较低，应尽量避免在大型模型中使用。