WorksheetBase.Protect 方法

项目
05/20/2013

保护工作表使其无法修改。

命名空间： Microsoft.Office.Tools.Excel
程序集： Microsoft.Office.Tools.Excel.v4.0.Utilities（在 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 中）

语法

声明
Public Sub Protect ( _
    password As Object, _
    drawingObjects As Object, _
    contents As Object, _
    scenarios As Object, _
    userInterfaceOnly As Object, _
    allowFormattingCells As Object, _
    allowFormattingColumns As Object, _
    allowFormattingRows As Object, _
    allowInsertingColumns As Object, _
    allowInsertingRows As Object, _
    allowInsertingHyperlinks As Object, _
    allowDeletingColumns As Object, _
    allowDeletingRows As Object, _
    allowSorting As Object, _
    allowFiltering As Object, _
    allowUsingPivotTables As Object _
)

public void Protect(
    Object password,
    Object drawingObjects,
    Object contents,
    Object scenarios,
    Object userInterfaceOnly,
    Object allowFormattingCells,
    Object allowFormattingColumns,
    Object allowFormattingRows,
    Object allowInsertingColumns,
    Object allowInsertingRows,
    Object allowInsertingHyperlinks,
    Object allowDeletingColumns,
    Object allowDeletingRows,
    Object allowSorting,
    Object allowFiltering,
    Object allowUsingPivotTables
)

参数

password
类型：System.Object
工作表的密码，区分大小写。如果省略此参数，则无需使用密码即可取消对工作表的保护。否则，您必须指定密码才能取消对工作表的保护。如果忘记密码，则无法取消对工作表的保护。最好将密码及其对应文档名的列表保存在安全的位置。

drawingObjects
类型：System.Object
为 true 时保护形状。默认值为 false。

contents
类型：System.Object
为 true 可保护锁定单元格中的内容。默认值为 true。

scenarios
类型：System.Object
为 true 时保护方案。默认值为 true。

userInterfaceOnly
类型：System.Object
为 true 可保护用户界面，但不保护宏。如果省略此参数，则同时对宏和用户界面应用保护。

allowFormattingCells
类型：System.Object
为 true，则允许用户格式化受保护的工作表上的任何单元格。默认值为 false。

allowFormattingColumns
类型：System.Object
为 true，则允许用户格式化受保护的工作表上的任何列。默认值为 false。

allowFormattingRows
类型：System.Object
为 true，则允许用户格式化受保护的工作表上的任何行。默认值为 false。

allowInsertingColumns
类型：System.Object
为 true，则允许用户在受保护的工作表上插入列。默认值为 false。

allowInsertingRows
类型：System.Object
为 true，则允许用户在受保护的工作表上插入行。默认值为 false。

allowInsertingHyperlinks
类型：System.Object
为 true，则允许用户在工作表上插入超链接。默认值为 false。

allowDeletingColumns
类型：System.Object
为 true，则允许用户在受保护的工作表上删除列，此处要删除的列中的每个单元格都已被解除锁定。默认值为 false。

allowDeletingRows
类型：System.Object
为 true，则允许用户在受保护的工作表上删除行，此处要删除的行中的每个单元格都已被解除锁定。默认值为 false。

allowSorting
类型：System.Object
为 true，则允许用户在受保护的工作表上进行排序。排序范围中的每个单元格都必须已解除锁定或不受保护。默认值为 false。

allowFiltering
类型：System.Object
为 true，则允许用户在受保护的工作表上设置筛选器。用户可以更改筛选条件，但不能启用或禁用自动筛选。用户可以在现有的自动筛选上设置筛选器。默认值为 false。

allowUsingPivotTables
类型：System.Object
为 true，则允许用户在受保护的工作表上使用数据透视表。默认值为 false。

备注

如果在 UserInterfaceOnly 参数设置为 true 的情况下应用此方法，然后保存该工作簿，则在重新打开该工作簿时，整个工作表（不仅仅是该界面）将被完全保护起来。若要在打开工作簿后重新启用用户界面保护，您必须在将 UserInterfaceOnly 设置为 true 的情况下再次应用此方法。

如果提供了密码，则可以对受保护的工作表进行更改。同时，另一个方法将解除对工作表的保护，进行必要的更改，然后再次将该工作表保护起来。

备注

“未保护的”意味着该单元格可能被锁定（“设置单元格格式”对话框），但包含在“允许用户编辑范围”对话框中定义的范围中，并且用户已使用密码取消对范围的保护或已通过 NT 权限验证。

可选参数

有关可选参数的信息，请参见Office 解决方案中的可选参数。

示例

下面的代码示例获取 ProtectContents 属性的值，以确定工作表的内容是否受保护。如果内容不受保护，则将 Contents 参数设置为 true 来调用 Protect 方法，以使该内容受保护。

此示例针对的是文档级自定义项。

Private Sub ProtectCellContents()
    If Not Me.ProtectContents Then
        If DialogResult.Yes = MessageBox.Show("Cell contents in this " & _
            "worksheet are not protected. Protect cell contents?", "Example", _
            MessageBoxButtons.YesNo) Then

            ' Protect cell contents, but do not change any 
            ' other protection type.
            Me.Protect(DrawingObjects:=Me.ProtectDrawingObjects, _
                Contents:=True, Scenarios:=Me.ProtectScenarios, _
                UserInterfaceOnly:=Me.ProtectionMode, _
                AllowFormattingCells:=Me.Protection.AllowFormattingCells, _
                AllowFormattingColumns:=Me.Protection.AllowFormattingColumns, _
                AllowFormattingRows:=Me.Protection.AllowFormattingRows, _
                AllowInsertingColumns:=Me.Protection.AllowInsertingColumns, _
                AllowInsertingRows:=Me.Protection.AllowInsertingRows, _
                AllowInsertingHyperlinks:=Me.Protection.AllowInsertingHyperlinks, _
                AllowDeletingColumns:=Me.Protection.AllowDeletingColumns, _
                AllowDeletingRows:=Me.Protection.AllowDeletingRows, _
                AllowSorting:=Me.Protection.AllowSorting, _
                AllowFiltering:=Me.Protection.AllowFiltering, _
                AllowUsingPivotTables:=Me.Protection.AllowUsingPivotTables)
        End If
    End If
End Sub

private void ProtectCellContents()
{
    if (!this.ProtectContents)
    {
        if (DialogResult.Yes == MessageBox.Show("Cell contents in this " +
            "worksheet are not protected. Protect cell contents?", "Example", 
            MessageBoxButtons.YesNo))
        {
            // Protect cell contents, but do not change any 
            // other protection type.
            this.Protect(this.ProtectDrawingObjects,
                true, this.ProtectScenarios, this.ProtectionMode, 
                this.Protection.AllowFormattingCells,
                this.Protection.AllowFormattingColumns,
                this.Protection.AllowFormattingRows,
                this.Protection.AllowInsertingColumns,
                this.Protection.AllowInsertingRows,
                this.Protection.AllowInsertingHyperlinks,
                this.Protection.AllowDeletingColumns,
                this.Protection.AllowDeletingRows,
                this.Protection.AllowSorting,
                this.Protection.AllowFiltering,
                this.Protection.AllowUsingPivotTables);
        }
    }
}

.NET Framework 安全性

对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。

请参见

参考

WorksheetBase 类

Microsoft.Office.Tools.Excel 命名空间

通过

WorksheetBase.Protect 方法

语法

参数

备注

可选参数

示例

.NET Framework 安全性

请参见

参考

其他资源