## BuiltInDocumentProperties indexer

返回[`DocumentProperty`](../../documentproperty/)对象通过属性名称.

```csharp
public override DocumentProperty this[string name] { get; }
```

| 范围 | 描述 |
| --- | --- |
| name | 要检索的属性的名称（不区分大小写）。 |

## 评论

属性的字符串名称对应于 typed 属性的名称，可从[`BuiltInDocumentProperties`](../)。

如果您请求的属性在文档中不存在，但该属性的 name 被识别为有效的内置名称，则会生成一个新的[`DocumentProperty`](../../documentproperty/)创建 ，将其添加到集合并返回。新创建的属性被赋值为 默认值（空字符串、零、`错误的`或 DateTime.MinValue，取决于内置属性的 type )。

如果您请求的属性在文档中不存在，并且 name 未被识别为内置名称，则`无效的`被退回。

## 例子

展示如何使用自定义文档属性。

```csharp
Document doc = new Document(MyDir + "Properties.docx");

// 每个文档都包含一个自定义属性集合，这些属性与内置属性一样，都是键值对。
 // 文档具有固定的内置属性列表。用户创建所有自定义属性。
Assert.AreEqual("Value of custom document property", doc.CustomDocumentProperties["CustomProperty"].ToString());

doc.CustomDocumentProperties.Add("CustomProperty2", "Value of custom document property #2");

Console.WriteLine("Custom Properties:");
foreach (var customDocumentProperty in doc.CustomDocumentProperties)
{
    Console.WriteLine(customDocumentProperty.Name);
    Console.WriteLine($"\tType:\t{customDocumentProperty.Type}");
    Console.WriteLine($"\tValue:\t\"{customDocumentProperty.Value}\"");
}
```

### 也可以看看

* class [DocumentProperty](../../documentproperty/)
* class [BuiltInDocumentProperties](../)
* 命名空间 [Aspose.Words.Properties](../../../aspose.words.properties/)
* 部件 [Aspose.Words](../../../)
