版本:Unity 6 (6000.0)
语言 : 英语
属性访问器
使用 PropertyVisitor 创建属性访问器

属性路径

属性路径是描述容器对象内属性位置的字符串。

概念

您可以使用属性路径来获取或设置特定路径下对象的 data,或对对象的子属性进行访问。

属性路径由字符串构建,并从根对象解析出特定的属性实例。例如,路径 foo.bar.baz[12] 解析嵌套在 foo 容器内的 bar 容器中的 baz 列表容器的第 13 个元素。

要创建和操作属性路径,请使用 Unity.Properties.PropertyPath 类。

您可以使用属性路径来执行以下操作:

  • 获取或设置特定路径下对象的 data
  • 对对象的子属性进行访问

性能注意事项

Unity.Properties.PropertyPath 是一个 不可变您无法更改不可变(只读)包的内容。这与可变相反。大多数包都是不可变的,包括从包注册表或通过 Git URL 下载的包。
参见 词汇表
结构类型。当您从字符串构建属性路径时,会为子字符串提取进行分配。

下表列出了从字符串构建属性路径时的分配行为。

字符串 长度 分配 分配原因
"Path" 1 0 按原样使用字符串。
"Path.To" 2 2 将字符串分成两部分。
"Path.To[2]" 3 3 将字符串分成两部分并提取索引。
"Path.To[2].My" 4 4
"Path.To[2].My.Value" 5 6 为附加部分分配数组。

下表列出了从部分构建属性路径时的分配行为。

字符串 长度 分配 分配原因
PropertyPath.FromName("Path") 1 0
PropertyPath.AppendName(previous, "To") 2 0
PropertyPath.AppendIndex(previous, 2) 3 0
PropertyPath.AppendName(previous, "My") 4 0
PropertyPath.AppendName(previous, "Value") 5 1 为附加部分分配数组。

为了优化性能并避免分配内存,

  • 在初始化例程期间初始化和缓存属性路径。
  • 合并或追加属性路径部分,而不是从字符串构建,最多四部分。

其他资源

属性访问器
使用 PropertyVisitor 创建属性访问器