ControlCollection.AddContentControl 方法 (ContentControl, String)
加入新的 ContentControl,此控制項是以文件中的原生內容控制項為基礎。
命名空間: Microsoft.Office.Tools.Word
組件: Microsoft.Office.Tools.Word (在 Microsoft.Office.Tools.Word.dll 中)
語法
'宣告
Function AddContentControl ( _
contentControl As ContentControl, _
name As String _
) As ContentControl
ContentControl AddContentControl(
ContentControl contentControl,
string name
)
參數
- contentControl
型別:Microsoft.Office.Interop.Word.ContentControl
Microsoft.Office.Interop.Word.ContentControl 是新控制項的基礎。
- name
型別:System.String
新控制項的名稱。
傳回值
型別:Microsoft.Office.Tools.Word.ContentControl
加入至文件中的 ContentControl。
例外狀況
例外狀況 | 條件 |
---|---|
ArgumentNullException | contentControl 為 nullnull 參考 (即 Visual Basic 中的 Nothing)。 -或- name 是 nullnull 參考 (即 Visual Basic 中的 Nothing),或長度為 0。 |
ControlNameAlreadyExistsException | ControlCollection 中已有相同名稱的控制項。 |
ArgumentException | contentControl 不是建置組塊陳列庫 (即 contentControl 的 Microsoft.Office.Interop.Word.ContentControl.Type 屬性,其值不是 Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText)。 |
備註
在執行階段使用這個方法加入新的 ContentControl,此控制項是以文件中的原生內容控制項為基礎。當您在執行階段建立 ContentControl,而且希望下次開啟文件時再建立相同的控制項時,這個控制項很好用。如需詳細資訊,請參閱在執行階段將控制項加入至 Office 文件。
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。