DocumentBase.Protect - метод

Статья
08/11/2011

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

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

Синтаксис

'Декларация
Public Sub Protect ( _
    type As WdProtectionType, _
    ByRef noReset As Object, _
    ByRef password As Object, _
    ByRef useIRM As Object, _
    ByRef enforceStyleLock As Object _
)

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 используется, чтобы разрешить пользователям добавлять в документ только примечания. Чтобы использовать этот пример, запустите его из класса ThisDocument в проекте уровня документа.

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);
}

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

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

См. также

Ссылки

DocumentBase Класс

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

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