WorkbookBase.ChangeFileAccess(XlFileAccess, Object, Object) Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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)

Paramètres

mode: XlFileAccess

Une des valeurs de l'objet XlFileAccess. Spécifie le nouveau mode d'accès.

writePassword: Object

Spécifie le mot de passe réservé en écriture si le fichier est réservé en écriture et s’il s’agit xlReadWritede Mode . Ignoré s’il n’existe aucun mot de passe pour le fichier ou si Mode est xlReadOnly.

notify: Object

true pour notifier l'utilisateur si le fichier n'est pas accessible immédiatement.

Exemples

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

Cet exemple concerne une personnalisation au niveau du document.

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

Remarques

Si vous avez un fichier ouvert en mode lecture seule, vous ne disposez pas d’un accès exclusif au fichier. Si vous remplacez un fichier en lecture-seule par lecture/écriture, Microsoft Office Excel doit charger une nouvelle copie du fichier pour s’assurer qu’aucune modification n’a été apportée pendant que le fichier était ouvert en lecture seule.

Paramètres facultatifs

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

S’applique à

Partager via