DocumentBase.Protect(WdProtectionType, Object, Object, Object, Object) Método

Definición

Espacio de nombres:

Microsoft.Office.Tools.Word

Ensamblado:

Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Aplica uno de los distintos tipos de protección disponibles al documento.

public void Protect (Microsoft.Office.Interop.Word.WdProtectionType type, ref object noReset, ref object password, ref object useIRM, ref object enforceStyleLock);

member this.Protect : Microsoft.Office.Interop.Word.WdProtectionType * obj * obj * obj * obj -> unit

Public Sub Protect (type As WdProtectionType, Optional ByRef noReset As Object, Optional ByRef password As Object, Optional ByRef useIRM As Object, Optional ByRef enforceStyleLock As Object)

Parámetros

type

WdProtectionType

Tipo de protección del documento especificado. WdProtectionType.

noReset

Object

false para restablecer los campos de formulario a sus valores predeterminados. true para mantener los valores de los campos de formulario actuales si el documento está protegido. Si Type no wdAllowOnlyFormFieldses , se omite el NoReset argumento .

password

Object

Contraseña que se solicita para quitar la protección del documento. Vea la sección Comentarios más adelante.

useIRM

Object

Especifica si se utiliza Information Rights Management (IRM) al proteger el documento para evitar cambios.

enforceStyleLock

Object

Especifica si se fuerzan las restricciones de formato en un documento protegido.

Ejemplos

En el ejemplo de código siguiente se usa el Protect método para permitir que los usuarios agreguen solo comentarios al documento. Para usar este ejemplo, ejecútelo desde la ThisDocument clase en un proyecto de nivel de documento.

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

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

Comentarios

Cuando un documento está protegido, los usuarios solo pueden realizar cambios limitados, como agregar anotaciones, realizar revisiones o completar un formulario. Si el documento ya está protegido al usar este método, se produce una excepción.

Evite usar contraseñas codificadas de forma rígida en las aplicaciones. Si se requiere una contraseña en un procedimiento, solicite la contraseña del usuario, almacénela en una variable y, a continuación, use la variable en el código.

Parámetros opcionales

Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.