WorkbookBase.ChangeFileAccess, méthode

Article
08/10/2011

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

mode
Type : Microsoft.Office.Interop.Excel.XlFileAccess
Une des valeurs XlFileAccess.Spécifie le nouveau mode d'accès.

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

WorkbookBase Classe

Microsoft.Office.Tools.Excel, espace de noms

Partager via