Compartir a través de

DocumentBase.Protect (Método)

  • Artículo

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

Espacio de nombres:  Microsoft.Office.Tools.Word
Ensamblado:  Microsoft.Office.Tools.Word.v4.0.Utilities (en Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintaxis

'Declaración
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
)

Parámetros

  • noReset
    Tipo: System.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 es wdAllowOnlyFormFields, el argumento NoReset se omite.
  • password
    Tipo: System.Object%
    Contraseña que se solicita para quitar la protección del documento.Vea la sección Comentarios más adelante.
  • useIRM
    Tipo: System.Object%
    Especifica si se utiliza Information Rights Management (IRM) al proteger el documento para evitar cambios.
  • enforceStyleLock
    Tipo: System.Object%
    Especifica si se fuerzan las restricciones de formato en un documento protegido.

Comentarios

Cuando un documento está protegido, los usuarios sólo pueden realizar cambios limitados, como agregar anotaciones, hacer revisiones o rellenar un formulario. Si el documento ya está protegido cuando se utiliza este método, se produce una excepción.

Evite el uso de contraseñas incluidas en el código de las aplicaciones. Si se requiere una contraseña en un procedimiento, solicite al usuario la contraseña, almacénela en una variable y, a continuación, utilice la variable en el código.

Parámetros opcionales

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

Ejemplos

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

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

Seguridad de .NET Framework

Vea también

Referencia

DocumentBase Clase

Microsoft.Office.Tools.Word (Espacio de nombres)