Document.Protect Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Применяет для документа один из нескольких типов защиты.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Public Sub Protect ( _
    Type As WdProtectionType, _
    ByRef NoReset As Object, _
    ByRef Password As Object, _
    ByRef UseIRM As Object, _
    ByRef EnforceStyleLock As Object _
)
'Применение
Dim instance As Document
Dim Type As WdProtectionType
Dim NoReset As Object
Dim Password As Object
Dim UseIRM As Object
Dim EnforceStyleLock As Object

instance.Protect(Type, NoReset, Password, _
    UseIRM, EnforceStyleLock)

public void Protect(
    WdProtectionType Type,
    ref Object NoReset,
    ref Object Password,
    ref Object UseIRM,
    ref Object EnforceStyleLock
)

Параметры

Type
Тип: Microsoft.Office.Interop.Word.WdProtectionType
Тип защиты для указанного документа. WdProtectionType.

NoReset
Тип: System.Object%
Значение false используется для сброса полей до значений по умолчанию. Значение true используется для сохранения текущих значений полей, если документ защищен. Если Type не является wdAllowOnlyFormFields, аргумент NoReset игнорируется.

Password
Тип: System.Object%
Пароль, необходимый для снятия защиты документа. (См. примечания ниже).

UseIRM
Тип: System.Object%
Определяет, следует ли использовать механизм управления правами на доступ к данным (IRM) для защиты документа от изменений.

EnforceStyleLock
Тип: System.Object%
Определяет, были ли в защищенном документе принудительно реализованы ограничения форматирования.

Заметки

В защищенном документе пользователи могут вносить лишь ограниченный набор изменений: например, добавление примечаний, правки или заполнение формы. Если документ уже защищен на момент использования данного метода, вызывается исключение.

Следует избегать использования в приложениях жестко заданных паролей. Если в процедуре необходим пароль, нужно запросить его у пользователя, сохранить в переменной и затем использовать эту переменную в программном коде.

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

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

Примеры

В приведенном ниже примере кода Protect используется, чтобы разрешить пользователям добавлять в документ только примечания.

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

Private Sub DocumentProtect(ByRef securelyStoredPassword As Object)
    Me.Protect(Word.WdProtectionType.wdAllowOnlyComments, _
        Password:=securelyStoredPassword)
End Sub

private void DocumentProtect(ref object securelyStoredPassword)
{
    this.Protect(Word.WdProtectionType.wdAllowOnlyComments,
        ref missing, ref securelyStoredPassword, ref missing, 
        ref missing);
}

Разрешения

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

См. также

Ссылки

Document Класс

Document - члены

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

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