HOW TO：使用內容控制項保護文件的部分

  • 發行項

更新： 2008 年 7 月

適用於

本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。

專案類型

  • 文件層級專案

  • 應用程式層級專案

Microsoft Office 版本

  • Word 2007

如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

當您保護文件的某個部分時，使用者即無法變更或刪除文件中該部分的內容。有多種方法可以使用內容控制項來保護 Microsoft Office Word 2007 文件的某個部分：

  • 您可以保護內容控制項。

  • 您可以保護文件中不在內容控制項內的部分。

保護內容控制項

您可以透過文件層級專案，於設計階段或執行階段設定該控制項的屬性，防止使用者編輯或刪除內容控制項。

從 Visual Studio 2008 Service Pack 1 (SP1) 開始，您也可以使用應用程式層級專案，保護您在執行階段加入至文件的內容控制項。如需詳細資訊，請參閱 HOW TO：將內容控制項加入至 Word 文件。

若要在設計階段保護內容控制項

  1. 在裝載 (Host) 於 Visual Studio 設計工具的文件中，選取想要保護的內容控制項。

  2. 在 [屬性] 視窗中，設定下列一個或兩個屬性：

    • 若要防止使用者編輯控制項，請將 [LockContents] 設定為 [True]。

    • 若要防止使用者刪除控制項，請將 [LockContentControl] 設定為 [True]。

  3. 按一下 [確定]。

若要透過文件層級專案在執行階段保護內容控制項

  • 將內容控制項的 LockContents 屬性設定為 true 防止使用者編輯控制項，並將 LockContentControl 屬性設定為 true 防止使用者刪除控制項。

    下列程式碼範例示範透過文件層級專案，使用兩個不同 RichTextContentControl 物件的 LockContents 和 LockContentControl 屬性。若要執行這個程式碼，請將程式碼加入至專案的 ThisDocument 類別 (Class) 中，並從 ThisDocument_Startup 事件處理常式呼叫 AddProtectedContentControls 方法。

    Dim deletableControl As Microsoft.Office.Tools.Word.RichTextContentControl
Dim editableControl As Microsoft.Office.Tools.Word.RichTextContentControl

Private Sub AddProtectedContentControls()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim range1 As Word.Range = Me.Paragraphs(1).Range

    deletableControl = Me.Controls.AddRichTextContentControl(range1, _
        "deletableControl")
    deletableControl.PlaceholderText = "You can delete this control, " & _
        "but you cannot edit it"
    deletableControl.LockContents = True

    range1.InsertParagraphAfter()
    Dim range2 As Word.Range = Me.Paragraphs(2).Range

    editableControl = Me.Controls.AddRichTextContentControl(range2, _
        "editableControl")
    editableControl.PlaceholderText = "You can edit this control, " & _
        "but you cannot delete it"
    editableControl.LockContentControl = True
End Sub

    private Microsoft.Office.Tools.Word.RichTextContentControl deletableControl;
private Microsoft.Office.Tools.Word.RichTextContentControl editableControl;

private void AddProtectedContentControls()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Word.Range range1 = this.Paragraphs[1].Range;

    deletableControl = this.Controls.AddRichTextContentControl(range1,
        "deletableControl");
    deletableControl.PlaceholderText = "You can delete this control, " +
        "but you cannot edit it";
    deletableControl.LockContents = true;

    range1.InsertParagraphAfter();
    Word.Range range2 = this.Paragraphs[2].Range;

    editableControl = this.Controls.AddRichTextContentControl(range2,
        "editableControl");
    editableControl.PlaceholderText = "You can edit this control, " +
        "but you cannot delete it";
    editableControl.LockContentControl = true;
}

若要透過應用程式層級專案在執行階段保護內容控制項

  • 將內容控制項的 LockContents 屬性設定為 true 防止使用者編輯控制項，並將 LockContentControl 屬性設定為 true 防止使用者刪除控制項。

    下列程式碼範例示範透過應用程式層級專案，使用兩個不同 RichTextContentControl 物件的 LockContents 和 LockContentControl 屬性。若要執行這段程式碼，請將程式碼加入至專案的 ThisAddIn 類別中，並從 ThisAddIn_Startup 事件處理常式呼叫 AddProtectedContentControls 方法。

    Dim deletableControl As Microsoft.Office.Tools.Word.RichTextContentControl
Dim editableControl As Microsoft.Office.Tools.Word.RichTextContentControl

Private Sub AddProtectedContentControls()
    Dim vstoDocument As Microsoft.Office.Tools.Word.Document = _
        Me.Application.ActiveDocument.GetVstoObject()
    vstoDocument.Paragraphs(1).Range.InsertParagraphBefore()
    Dim range1 As Word.Range = vstoDocument.Paragraphs(1).Range

    deletableControl = vstoDocument.Controls.AddRichTextContentControl(range1, _
        "deletableControl")
    deletableControl.PlaceholderText = "You can delete this control, " & _
        "but you cannot edit it"
    deletableControl.LockContents = True

    range1.InsertParagraphAfter()
    Dim range2 As Word.Range = vstoDocument.Paragraphs(2).Range

    editableControl = vstoDocument.Controls.AddRichTextContentControl(range2, _
        "editableControl")
    editableControl.PlaceholderText = "You can edit this control, " & _
        "but you cannot delete it"
    editableControl.LockContentControl = True
End Sub

    private Microsoft.Office.Tools.Word.RichTextContentControl deletableControl;
private Microsoft.Office.Tools.Word.RichTextContentControl editableControl;

private void AddProtectedContentControls()
{
    Microsoft.Office.Tools.Word.Document vstoDocument = 
        this.Application.ActiveDocument.GetVstoObject();
    vstoDocument.Paragraphs[1].Range.InsertParagraphBefore();
    Word.Range range1 = vstoDocument.Paragraphs[1].Range;

    deletableControl = vstoDocument.Controls.AddRichTextContentControl(range1,
        "deletableControl");
    deletableControl.PlaceholderText = "You can delete this control, " +
        "but you cannot edit it";
    deletableControl.LockContents = true;

    range1.InsertParagraphAfter();
    Word.Range range2 = vstoDocument.Paragraphs[2].Range;

    editableControl = vstoDocument.Controls.AddRichTextContentControl(range2,
        "editableControl");
    editableControl.PlaceholderText = "You can edit this control, " +
        "but you cannot delete it.";
    editableControl.LockContentControl = true;
}

保護文件中不在內容控制項內的部分

您可以將文件區域放入 GroupContentControl 中，防止使用者變更該區域。這在下列情況下十分有用：

  • 您想要保護不含內容控制項的區域。

  • 您想要保護已包含內容控制項的區域，但是想要保護的文字或其他項目不在內容控制項內。

注意事項：

如果建立的 GroupContentControl 包含內嵌內容控制項，則不會自動保護這些內嵌內容控制項。若要防止使用者編輯內嵌內容控制項，請使用控制項的 LockContents 屬性。

若要在設計階段保護文件的區域

  1. 在裝載於 Visual Studio 設計工具的文件中，選取想要保護的區域。

  2. 按一下 [功能區] 上的 [開發人員] 索引標籤。

    注意事項：

    如果 [開發人員] 索引標籤沒有顯示，您必須先使其顯示。如需詳細資訊，請參閱 HOW TO：在功能區顯示開發人員索引標籤。

  3. 按一下 [控制項] 群組中的 [群組] 下拉按鈕，然後按一下 [群組]。

    這樣會在專案的 ThisDocument 類別中，自動產生內含保護區域的 GroupContentControl。在設計階段可以看到代表群組控制項的框線，但是在執行階段則看不到框線。

若要透過文件層級專案在執行階段保護文件的區域

  • 以程式設計方式選取想要保護的區域，然後呼叫 AddGroupContentControl 方法以建立 GroupContentControl。

    下列程式碼範例會將文字加入至文件的第一段，然後選取第一段，再具現化 GroupContentControl。若要執行這個程式碼，請將程式碼加入至專案的 ThisDocument 類別中，並從 ThisDocument_Startup 事件處理常式呼叫 ProtectFirstParagraph 方法。

    Dim groupControl1 As Microsoft.Office.Tools.Word.GroupContentControl

Private Sub ProtectFirstParagraph()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim range1 As Word.Range = Me.Paragraphs(1).Range
    range1.Text = "You cannot edit or change the formatting of text " & _
            "in this paragraph, because this paragraph is in a GroupContentControl."
    range1.Select()

    groupControl1 = Me.Controls.AddGroupContentControl("groupControl1")
End Sub

    private Microsoft.Office.Tools.Word.GroupContentControl groupControl1;

private void ProtectFirstParagraph()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Word.Range range1 = this.Paragraphs[1].Range;

    range1.Text = "You cannot edit or change the formatting of text " +
        "in this sentence, because this sentence is in a GroupContentControl.";
    range1.Select();
    groupControl1 = this.Controls.AddGroupContentControl("groupControl1");
}

若要透過應用程式層級專案在執行階段保護文件的區域

  • 以程式設計方式選取想要保護的區域，然後呼叫 AddGroupContentControl 方法以建立 GroupContentControl。

    下列程式碼範例會將文字加入至現用文件的第一個段落，然後選取此段落，再具現化 GroupContentControl。若要執行這段程式碼，請將程式碼加入至專案的 ThisAddIn 類別中，並從 ThisAddIn_Startup 事件處理常式呼叫 ProtectFirstParagraph 方法。

    Dim groupControl1 As Microsoft.Office.Tools.Word.GroupContentControl

Private Sub ProtectFirstParagraph()
    Dim vstoDocument As Microsoft.Office.Tools.Word.Document = _
        Me.Application.ActiveDocument.GetVstoObject()
    vstoDocument.Paragraphs(1).Range.InsertParagraphBefore()

    Dim range1 As Word.Range = vstoDocument.Paragraphs(1).Range
    range1.Text = "You cannot edit or change the formatting of text " & _
            "in this paragraph, because this paragraph is in a GroupContentControl."
    range1.Select()

    groupControl1 = vstoDocument.Controls.AddGroupContentControl("groupControl1")
End Sub

    private Microsoft.Office.Tools.Word.GroupContentControl groupControl1;

private void ProtectFirstParagraph()
{
    Microsoft.Office.Tools.Word.Document vstoDocument =
        this.Application.ActiveDocument.GetVstoObject();
    vstoDocument.Paragraphs[1].Range.InsertParagraphBefore();

    Word.Range range1 = vstoDocument.Paragraphs[1].Range;
    range1.Text = "You cannot edit or change the formatting of text " +
        "in this sentence, because this sentence is in a GroupContentControl.";
    range1.Select();

    groupControl1 = vstoDocument.Controls.AddGroupContentControl("groupControl1");
}

請參閱

工作

HOW TO：將內容控制項加入至 Word 文件

概念

內容控制項

主項目和主控制項概觀

主項目和主控制項的程式設計限制

在執行階段將控制項加入至 Office 文件

主控制項的 Helper 方法

其他資源

Word 主控制項

變更記錄

日期

記錄

原因

2008 年 7 月

加入應用程式層級增益集的程序。

SP1 功能變更。