WorkbookBase.Protect - метод

Статья
08/11/2011

Защищает книгу от изменений.

Пространство имен: 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, _
    structure As Object, _
    windows As Object _
)

public void Protect(
    Object password,
    Object structure,
    Object windows
)

Параметры

password
Тип: System.Object
Пароль доступа к книге, задаваемый с учетом регистра.Если этот аргумент не задан, можно снять защиту рабочей книги, не используя пароль.В противном случае чтобы снять защиту книги, необходимо указать пароль.

structure
Тип: System.Object
Значение true, чтобы защитить структуру книги (относительное положение листов).Значение по умолчанию — false.

windows
Тип: System.Object
Значение true, чтобы защитить окна книги.Если этот аргумент не задан, защита для окон отсутствует.

Заметки

Надежный пароль должен состоять из строчных и прописных букв, цифр и символов. Ненадежный пароль не содержит сочетания этих элементов. Например, «Y6dh!et5» — надежный пароль, а «House27» — нет. Надежный пароль должен легко запоминаться, чтобы его не нужно было записывать.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Примеры

В следующем примере кода метод Protect вызывается для защиты структуры книги и окон книги, но без установки защиты паролем. После этого программный код в данном примере проверяет, установлена ли такая защита, путем обращения к свойствам ProtectStructure и ProtectWindows.

В этом примере демонстрируется настройка уровня документа.

Private Sub ProtectWorkbook()
    Me.Protect(Structure:=True, Windows:=True)

    If Me.ProtectStructure Then
        MsgBox("You cannot add, delete or change the location " & _
            "of sheets in this workbook.")
    End If

    If Me.ProtectWindows Then
        MsgBox("You cannot arrange windows in this workbook.")
    End If
End Sub

private void ProtectWorkbook()
{
    this.Protect(missing, true, true);

    if (this.ProtectStructure)
    {
        MessageBox.Show("You cannot add, delete or change the location " +
            "of sheets in this workbook.");
    }

    if (this.ProtectWindows)
    {
        MessageBox.Show("You cannot arrange windows in this workbook.");
    }
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

WorkbookBase Класс

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через