Metodo Document.UnprotectDocument (System 2007)

Articolo
09/12/2008

Aggiornamento: Luglio 2008

Chiamato dal runtime di Visual Studio Tools per Office in modo che sia possibile rimuovere la password di protezione dal documento e consentire il salvataggio dei dati memorizzati nella cache.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)

Sintassi

Protected Overridable Sub UnprotectDocument

Me.UnprotectDocument()

protected virtual void UnprotectDocument()

Note

Eseguire l'override di questo metodo in un progetto a livello di documento per Word se il documento è protetto tramite una password e contiene dati memorizzati nella cache che potrebbero essere modificati in fase di esecuzione. Nell'implementazione di questo metodo, utilizzare il metodo Unprotect per rimuovere temporaneamente la protezione del documento.

Per impostazione predefinita, le modifiche ai dati memorizzati nella cache in un documento protetto da password non sono salvate in modo permanente quando viene salvato il documento. Per salvare le modifiche apportate ai dati memorizzati nella cache è necessario eseguire l'override dei metodi seguenti del progetto:

UnprotectDocument. Quando il documento viene salvato, il runtime di Visual Studio Tools per Office chiama questo metodo. Aggiungere il codice a questo metodo che rimuove temporaneamente la protezione del documento. Ciò consente il salvataggio delle modifiche apportate ai dati memorizzati nella cache.
ProtectDocument. Dopo aver salvato il documento, il runtime di Visual Studio Tools per Office chiama questo metodo. Aggiungere a questo metodo il codice per applicare nuovamente la protezione al documento.

Per ulteriori informazioni, vedere la classe Procedura: memorizzare dati nella cache di un documento protetto da password.

Esempi

Nell'esempio di codice seguente viene illustrato come eseguire l'override del metodo UnprotectDocument per rimuovere temporaneamente la protezione del documento in modo che sia possibile salvare le modifiche apportate ai dati memorizzati nella cache. Viene innanzitutto salvato il valore ProtectionType corrente, in modo che sia possibile riapplicare lo stesso tipo di protezione in un secondo momento nel metodo ProtectDocument. Per utilizzare questo codice, eseguirlo dalla classe ThisDocument in un progetto a livello di documento per Word. Nel codice si presuppone che la password sia memorizzata in un campo denominato 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);
}

Autorizzazioni

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.