Data Standard 中的 $Prop[] 变量

$Prop[] 变量提供对 Vault 特性的访问（用在 Data Standard for Vault 中时）或对 CAD 特性的访问（用在 Data Standard for CAD 中时）。在方括号 [] 中指定特性名称可返回一个 IProperty 对象，该对象可用于获取和设置特性值。

类型：Common.Wpf.IndexerForwarder、IProperty

特殊特性

对于常规特性，必须使用该特性的名称。

但某些特殊的只读特性允许通过 $Prop 变量访问其他信息。这些特性具有下划线前缀 (_)。

注： “可用性”列指示可在哪些 PowerShell 文件中使用这些对象。例如，Vault 文件对话框意味着，PowerShell 代码被在创建和编辑文件对话框的环境中使用。

特殊特性	可用性	描述
_Category	Vault：文件、文件夹、自定义对象 AutoCAD、Inventor	值类型：string 设置为针对现有的 Vault 对象指定的类别。
_CreateMode	Vault：文件、文件夹、自定义对象 AutoCAD、Inventor	值类型：bool 可用在 PowerShell 函数中，以确定 Data Standard 窗口是否处于创建模式。当文件首次被保存时，该窗口处于创建模式。
_CopyMode	Inventor、AutoCAD	值类型：bool 可用在 PowerShell 函数中，以确定 Data Standard 窗口是否处于复制模式。对于 Data Standard 功能“复制”和“替换为副本”，设置为 true。 注： 当 _CopyMode 为 true 时，_CreateMode 也被设置为 true。
_EditMode	Vault：文件、文件夹、自定义对象 AutoCAD、Inventor	值类型：bool 可用在 PowerShell 函数中，以确定 Data Standard 窗口是否处于编辑模式。对于以下 Data Standard 函数，设置为 true：Datasheet。
_Format	Inventor	值类型：string 设置为针对 Inventor 对象指定的格式或 ListValues 的第一个元素。 ListValues 的类型：List<字符串>，包含格式列表，具体取决于文档类型。 对于工程图：PDF、DXF、DWG 对于模型：JT、STEP
_FileExt	Vault：文件 AutoCAD、Inventor	值类型：string 包含文件扩展名。
_FileName	Vault：文件 AutoCAD、Inventor	值类型：string 包含不带扩展名的文件名。
_FilePath	Vault：文件 AutoCAD、Inventor	值类型：string 包含 Vault 文件路径（以 $ 开头），但不包含文件名。
_FolderName	Vault：文件夹	值类型：string 包含文件夹名称。
_FolderPath	Vault：文件夹	值类型：string 包含 Vault 文件夹路径（以 $ 开头），但不包含文件名。
_GeneratedNumber	Vault：文件	值类型：string 包含生成的编号。该值由 DSNumSchemeCtrl 设置。有关详细信息，请参见编号。
_OriginalFileName	AutoCAD、Inventor	值类型：string 在执行“副本”或“包含工程图的副本”事件时包含源文档的名称。
_SaveCopyAsMode	Inventor	值类型：bool 当 Inventor 用户单击“保存副本为”按钮时值设置为 true，否则设置为 false。
_SuggestedVaultPath	Inventor	值类型：string 包含直接相关文件的路径，例如，在部件环境中创建的零部件的父部件的路径，或者工程图中主零部件视图的路径。
_VaultVirtualPath	Inventor	值类型：string 包含在 Inventor 项目文件中定义的 Vault 映射虚拟文件夹。
_WorkspacePath	Inventor	值类型：string 包含在 Inventor 项目文件中定义的工作空间路径。

本地化

如果方括号 [] 中的特性名称以前缀 _XLTN_ 开头（例如，$prop["_XLTN_TITLE_ITEM_CO"].Value），则该名称被映射到本地化 Vault 服务器版本的实际特性名称。有关详细信息，请参见本地化。

对象 IProperty

IProperty 对象是基本 Vault 或 CAD 特性的包装器。

注： 对于特性“Title”，表达式 $prop["Title"] 只返回一个 IProperty 对象。它不会返回该特性的直接值。

特性

名称	类型	说明
值	object	返回该特性的值。可用于获取或设置特性值。
IsValid	bool	检查该特性是否有效。
IsInvalid	bool	IsValid 的反值。很有用，因为在 XAML 中不容易求反值。
ListValues	对象 数组 (Array)	仅用于特殊特性“_Category”。返回一个字符串列表。
EnforceListValues	bool	获取现有值（如果有），或者可将其设置为被替代
IsObligatory	bool	获取现有值（如果有），或者可将其设置为被替代
最小长度	整数	获取现有值（如果有），或者可将其设置为被替代
MaximumLength	整数	获取现有值（如果有），或者可将其设置为被替代
案例	字符串	获取现有值（如果有），或者可将其设置为被替代
MinimumDate	DateTime	获取现有值（如果有），或者可将其设置为被替代
MaximumDate	DateTime	获取现有值（如果有），或者可将其设置为被替代
MinimumValue	整数	获取现有值（如果有），或者可将其设置为被替代
MaximumValue	整数	获取现有值（如果有），或者可将其设置为被替代
CustomValidation	ScriptBlock	执行脚本块并返回结果。脚本块应该会返回布尔值。如果这样进行设置，则所有其他约束都不会被执行。
CustomValidationErrorMessage	字符串	如果上述 CustomValidation 返回 false，则此处设置的所有文本都将显示为此 Prop 对象所绑定到的控件上的工具提示。

事件

名称	描述
PropertyChanged	在特性值更改时发生。有关示例，请参见示例 - 将事件与 Data Standard 对话框结合使用。

示例

在 PowerShell 中，可使用以下语法访问特性：

PowerShell

$fileName = $Prop["_FileName"].Value

可以通过 XAML 绑定访问相同的对象。但语法略有不同：

XAML

<TextBox Text="{Binding Prop[_FileName].Value}"/>