DocumentBase.Protect(WdProtectionType, Object, Object, Object, Object) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.Office.Tools.Word
Assembly:
Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Applica al documento uno tra diversi tipi di protezione.

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)

Parametri

type
WdProtectionType

Tipo di protezione per il documento specificato. WdProtectionType.

noReset
Object

false per reimpostare i campi modulo sui relativi valori predefiniti. true per mantenere i valori correnti dei campi modulo se il documento è protetto. Se Type non wdAllowOnlyFormFieldsè , l'argomento NoReset viene ignorato.

password
Object

Password richiesta per rimuovere la protezione dal documento. Vedere la sezione Osservazioni riportata di seguito.

useIRM
Object

Specifica se utilizzare il servizio Information Rights Management (IRM) per proteggere il documento da eventuali modifiche.

enforceStyleLock
Object

Specifica se a un documento protetto sono applicate restrizioni di formattazione.

Esempio

Nell'esempio di codice seguente viene utilizzato il Protect metodo per consentire agli utenti di aggiungere solo commenti al documento. Per usare questo esempio, eseguirlo dalla ThisDocument classe in un progetto a livello di 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

Commenti

Quando un documento è protetto, gli utenti possono apportare solo modifiche limitate, ad esempio l'aggiunta di annotazioni, l'esecuzione di revisioni o il completamento di un modulo. Se il documento è già protetto quando si utilizza questo metodo, viene generata un'eccezione.

Evitare di usare password hardcoded nelle applicazioni. Se una password è necessaria in una procedura, richiedere la password all'utente, archiviarla in una variabile e quindi usare la variabile nel codice.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere parametri facoltativi nelle soluzioni Office.

Si applica a