如图所示，在Solidworks的模型，图纸文档中，都存在【自定义】【配置特定】属性，在这里可以给模型和图纸添加各种属性，以便属性数据反应在图纸上或提供下游生产制造使用。而当属性数量越来越多后，这些属性的写入与读取将会带来繁重的机械工作，人为地录入，不仅效率低下，还可能导致错误率的提升。本文将带领读者入门Solidworks中属性的自动添加与读取操作。
image.png
1.属性管理器对象获取
属性的写入与读取，需要使用到属性管理器对象CustomPropertyManager，该对象可由如下最常用的2种方式获取：
1）通过扩展文档对象获得（最为常用）
ModelDoc2 SwDoc;
ModelDocExtension SwDocExt=SwDoc.Extension；
CustomPropertyManager SwCusp=SwDocExt.CustomPropertyManager[ConfigName];
其中参数ConfigName，指操作的配置【配置特定】，如果为空，则表示操作【自定义】
image.png
2）通过配置对象获得
Configuration SwConfig;
CustomPropertyManager SwCusp=SwConfig.CustomPropertyManager;
2.属性的自动写入
自动写入属性，可以使用如下方法
CustomPropertyManager SwCusp；
value = SwCusp.Add3(FieldName, FieldType, FieldValue, OverwriteExisting)
image.png
image.png
image.png
实例讲解：
如下图，我们给模型自动写入如下属性
image.png
实例代码：
public static void WriteCusp(ModelDoc2 Doc)
{
CustomPropertyManager SwCusp = Doc.Extension.CustomPropertyManager[""];
string PartName = "长方体 \"D2@草图2@Solidworks属性学习.SLDPRT\"X\"D1@草图2@Solidworks属性学习.SLDPRT\"X\"D1@凸台-拉伸1@Solidworks属性学习.SLDPRT\"";
SwCusp.Add3("零件名", (int)swCustomInfoType_e.swCustomInfoText, PartName, (int)swCustomPropertyAddOption_e.swCustomPropertyReplaceValue);
SwCusp.Add3("代号", (int)swCustomInfoType_e.swCustomInfoText, "001", (int)swCustomPropertyAddOption_e.swCustomPropertyReplaceValue);
SwCusp.Add3("重量", (int)swCustomInfoType_e.swCustomInfoText, "\"SW-质量@Solidworks属性学习.SLDPRT\"", (int)swCustomPropertyAddOption_e.swCustomPropertyReplaceValue);
SwCusp.Add3("材料", (int)swCustomInfoType_e.swCustomInfoText, "\"SW-材质@Solidworks属性学习.SLDPRT\"", (int)swCustomPropertyAddOption_e.swCustomPropertyReplaceValue);
System.Windows.MessageBox.Show("属性写入成功!");
}
3.属性的读取
自定读取属性，可以使用如下方法
CustomPropertyManager SwCusp；
SwCusp.Get5(FieldName, UseCached, ValOut, ResolvedValOut, WasResolved)
image.png
image.png
实例讲解：
同样，我们读取之前写入的属性，代码示例如下：
public static void ReadCusp(ModelDoc2 Doc)
{
StringBuilder Sb = new StringBuilder("");
CustomPropertyManager SwCusp = Doc.Extension.CustomPropertyManager[""];
string outv = "";
string outr = "";
bool outresult = false;
SwCusp.Get5("零件名", true, out outv, out outr, out outresult);
Sb.Append("[零件名]:\r\n表达式:"+ outv+"\r\n评估值:"+ outr);
Sb.Append("\r\n");
SwCusp.Get5("代号", true, out outv, out outr, out outresult);
Sb.Append("[代号]:\r\n表达式:" + outv + "\r\n评估值:" + outr);
Sb.Append("\r\n");
SwCusp.Get5("材料", true, out outv, out outr, out outresult);
Sb.Append("[材料]:\r\n表达式:" + outv + "\r\n评估值:" + outr);
System.Windows.MessageBox.Show(Sb.ToString().Trim());
}
运行效果图：
image.png
如下图为本文的示例程序，源码可上我的Github下载。操作步骤可见文章《公众号源码Github分享库》， 实例序号9
image.png
