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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Condividi tramite