Metodo WorkbookBase.ChangeFileAccess

Articolo
08/11/2011

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

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
Public Sub ChangeFileAccess ( _
    mode As XlFileAccess, _
    writePassword As Object, _
    notify As Object _
)

public void ChangeFileAccess(
    XlFileAccess mode,
    Object writePassword,
    Object notify
)

Parametri

mode
Tipo: Microsoft.Office.Interop.Excel.XlFileAccess
Uno dei valori di XlFileAccess.Specifica la nuova modalità di accesso.

writePassword
Tipo: System.Object
Specifica la password di protezione dalla scrittura se il file è protetto dalla scrittura e il parametro Mode è impostato su xlReadWrite.Viene ignorata se non esiste alcuna password per il file o se Mode è impostato su xlReadOnly.

notify
Tipo: System.Object
true per notificare all'utente se non è possibile accedere immediatamente al file.

Note

Se un file è aperto in modalità sola lettura, non si dispone di accesso esclusivo al file. Se la modalità del file viene modificata in lettura/scrittura, è necessario caricare in Microsoft Office Excel una nuova copia del file per assicurarsi che non siano state apportate modifiche mentre il file era aperto in sola lettura.

Parametri facoltativi

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

Esempi

Nell'esempio di codice riportato di seguito viene visualizzato un messaggio se la proprietà ReadOnlyRecommended è impostata su true e la proprietà ReadOnly è impostata su false. Viene quindi chiesto all'utente di impostare l'accesso al file in sola lettura chiamando il metodo ChangeFileAccess.

Questo esempio è valido per una personalizzazione a livello di documento.

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

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,
                missing, false);
        }
    }
}

Sicurezza di .NET Framework

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.

Vedere anche

Riferimenti

WorkbookBase Classe

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite