WorkbookBase.ChangeFileAccess(XlFileAccess, Object, Object) Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.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.

Modifica le autorizzazioni di accesso per la cartella di lavoro. È possibile che sia necessaria una versione aggiornata da caricare dal disco.

public void ChangeFileAccess (Microsoft.Office.Interop.Excel.XlFileAccess mode, object writePassword, object notify);

member this.ChangeFileAccess : Microsoft.Office.Interop.Excel.XlFileAccess * obj * obj -> unit

Public Sub ChangeFileAccess (mode As XlFileAccess, Optional writePassword As Object, Optional notify As Object)

Parametri

mode: XlFileAccess

Uno dei valori di XlFileAccess. Specifica la nuova modalità di accesso.

writePassword: Object

Specifica la password riservata in scrittura se il file è riservato e Mode è xlReadWrite. Ignorato se non è presente alcuna password per il file o se Mode è xlReadOnly.

notify: Object

true per notificare all'utente se non è possibile accedere immediatamente al file.

Esempio

Nell'esempio di codice seguente viene visualizzato un messaggio se la ReadOnlyRecommended proprietà è e la ReadOnly proprietà è truefalsee quindi viene richiesto all'utente di impostare l'accesso al file in sola lettura chiamando il ChangeFileAccess metodo .

Questo esempio è relativo a una personalizzazione a livello di documento.

private void MakeWorkbookReadOnly()
{
    if (this.ReadOnlyRecommended && !this.ReadOnly)
    {
        // Change the access level of the document to read-only if the user 
        // clicks yes.
        if (MessageBox.Show("Set this document to read-only?",
            "Sample", MessageBoxButtons.YesNo) == DialogResult.Yes)
        {
            this.ChangeFileAccess(Excel.XlFileAccess.xlReadOnly,
                 false);
        }
    }
}

Private Sub MakeWorkbookReadOnly()
    If Me.ReadOnlyRecommended AndAlso Not Me.ReadOnly Then
        ' Change the access level of the document to read-only  
        ' if the user clicks yes.
        If MessageBox.Show("Set this document to read-only?", _
            "Sample", MessageBoxButtons.YesNo) = DialogResult.Yes Then
            Me.ChangeFileAccess(Excel.XlFileAccess.xlReadOnly, Notify:=False)
        End If
    End If
End Sub

Commenti

Se si dispone di un file aperto in modalità di sola lettura, non si ha accesso esclusivo al file. Se si modifica un file da sola lettura/scrittura, Microsoft Office Excel deve caricare una nuova copia del file per assicurarsi che non siano state apportate modifiche mentre il file è stato aperto come di sola lettura.

Parametri facoltativi

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

Si applica a

Condividi tramite