Document.UnprotectDocument (Método) (2007 System)

Actualización: Julio de 2008

Llamado por el motor en tiempo de ejecución de Visual Studio Tools para Office para que pueda quitar la protección con contraseña del documento y pueda guardar los datos almacenados en la memoria caché.

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

Sintaxis

Protected Overridable Sub UnprotectDocument

Me.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. El motor en tiempo de ejecución de Visual Studio Tools para Office llama a este método cuando se guarda el documento. 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, el motor en tiempo de ejecución de 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. Para utilizar este código, ejecútelo desde la clase ThisDocument en un proyecto en el nivel del documento para Word. El código da por supuesto que la contraseña está almacenada en un campo denominado securelyStoredPassword.

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

Permisos

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.