Autodesk.Revit.DB.NullParameterValue

简要介绍

Autodesk.Revit.DB.NullParameterValue 是 Revit API 中的一个类，用于表示 Revit 参数的无效值。

使用方法

NullParameterValue 类中只有一个公共静态属性 Instance，表示 NullParameterValue 的实例对象。

在使用 Revit API 中的许多方法时，可以将参数赋值为 NullParameterValue.Instance，表示该参数没有有效值，并且无需为其指定任何值。

例如，下面的代码片段演示了将 NullParameterValue.Instance 用作 InputPointOptions 的 PointFilter 参数：

InputPointOptions options = new InputPointOptions();
options.PointFilter = NullParameterValue.Instance;
XYZ point = uiDoc.Selection.PickPoint(options);

注意事项

• 不要使用 new 运算符创建 NullParameterValue 对象，应该直接使用 NullParameterValue.Instance 属性。
• NullParameterValue.Instance 不能赋值给 ValueType 类型的参数，因为 ValueType 不能为 null。
• NullParameterValue.Instance 不能用于表示空字符串（string.Empty）。

示例代码

// 使用 NullParameterValue 表示参数没有有效值
Parameter param = element.LookupParameter("MyParameter");
if (param != null)
{
    if (myValue > 0) // 有有效值
    {
        param.Set(myValue);
    }
    else // 没有有效值
    {
        param.Set(NullParameterValue.Instance);
    }
}

// 演示将 NullParameterValue 用作 InputPointOptions 的 PointFilter 参数
InputPointOptions options = new InputPointOptions();
options.PointFilter = NullParameterValue.Instance;
XYZ point = uiDoc.Selection.PickPoint(options);

参考链接

• Autodesk.Revit.DB.NullParameterValue Class: https://www.revitapidocs.com/2022/d766f2fe-7af5-437d-1047-c219f936fe8b.htm