DocumentBase.UnprotectDocument (Método)

Artículo
08/10/2011

Brinda la oportunidad de quitar la protección con contraseña del documento y guardar los datos almacenados en la memoria caché.

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
Protected Overridable Sub UnprotectDocument

protected virtual void UnprotectDocument()

Comentarios

Invalide este método en un proyecto en el nivel del documento para Word si el documento se protege utilizando una contraseña y contiene datos almacenados en memoria caché que se podrían cambiar en tiempo de ejecución. En la implementación de este método, utilice el método Unprotect para desproteger temporalmente el documento.

De forma predeterminada, los cambios efectuados en los datos almacenados en memoria caché en un documento protegido mediante contraseña no se conservan cuando se guarda el documento. Para guardar los cambios efectuados en los datos almacenados en la memoria caché, debe invalidar los métodos siguientes en el proyecto:

UnprotectDocument. Una vez que el documento se ha guardado, Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office llama a este método. Agregue código a este método que desproteja el documento temporalmente. Esto permite guardar los cambios efectuados en los datos almacenados en la memoria caché.
ProtectDocument. Una vez que el documento se ha guardado, Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office llama a este método. Agregue código a este método que vuelva a aplicar la protección al documento.

Para obtener más información, vea Cómo: Almacenar datos en caché en un documento protegido por contraseña.

Ejemplos

El ejemplo de código siguiente muestra cómo invalidar el método UnprotectDocument para desproteger temporalmente el documento para que cambia a los datos almacenados en memoria caché puede estar guardado. En el ejemplo se guarda primero el valor ProtectionType, de manera que se pueda aplicar el mismo tipo de protección más adelante en el método ProtectDocument. El código da por supuesto que la contraseña está almacenada en un campo denominado securelyStoredPassword. Para usar este ejemplo, ejecútelo desde la clase ThisDocument en un proyecto de nivel de documento.

<CachedAttribute()> _
Public CachedString As String = "This string is cached in the document."

Private protectionTypeValue As Word.WdProtectionType

Protected Overrides Sub UnprotectDocument()
    If Me.ProtectionType <> Word.WdProtectionType.wdNoProtection Then
        protectionTypeValue = Me.ProtectionType
        Me.Unprotect(securelyStoredPassword)
    End If
End Sub

Protected Overrides Sub ProtectDocument()
    Me.Protect(protectionTypeValue, Password:=securelyStoredPassword)
End Sub

[CachedAttribute]
public string CachedString = "This string is cached in the document.";

private Word.WdProtectionType protectionTypeValue;

protected override void UnprotectDocument()
{
    if (this.ProtectionType != Word.WdProtectionType.wdNoProtection)
    {
        protectionTypeValue = this.ProtectionType;
        this.Unprotect(ref securelyStoredPassword);
    }
}

protected override void ProtectDocument()
{
    this.Protect(protectionTypeValue, ref missing,
        ref securelyStoredPassword, ref missing, ref missing);
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.