Partager via


WorkbookBase.ChangeFileAccess, méthode

Modifie les autorisations d'accès pour le classeur. Cela peut nécessiter le chargement d'une version à jour à partir du disque.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel.v4.0.Utilities (dans Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

'Déclaration
Public Sub ChangeFileAccess ( _
    mode As XlFileAccess, _
    writePassword As Object, _
    notify As Object _
)
public void ChangeFileAccess(
    XlFileAccess mode,
    Object writePassword,
    Object notify
)

Paramètres

  • writePassword
    Type : System.Object
    Spécifie le mot de passe réservé en écriture si le fichier est réservé en écriture et si Mode est xlReadWrite.Ignoré s'il n'y a pas de mot de passe pour le fichier ou si Mode est xlReadOnly.
  • notify
    Type : System.Object
    true pour notifier l'utilisateur si le fichier n'est pas accessible immédiatement.

Notes

Si vous avez un fichier ouvert en mode en lecture seule, vous n'avez pas d'accès exclusif au fichier. Si vous faites passer un fichier du mode lecture seule au mode lecture/écriture, Microsoft Office Excel doit charger une nouvelle copie du fichier afin de garantir qu'aucune modification n'a été apportée pendant que le fichier était ouvert en lecture seule.

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant affiche un message si la propriété ReadOnlyRecommended a la valeur true et la propriété ReadOnly a la valeur false, puis invite l'utilisateur à définir l'accès au fichier en lecture seule en appelant la méthode ChangeFileAccess.

Cet exemple illustre une personnalisation au niveau du document.

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

Sécurité .NET Framework

Voir aussi

Référence

WorkbookBase Classe

Microsoft.Office.Tools.Excel, espace de noms