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

Referência

Definição

Namespace:: Microsoft.Office.Tools.Excel

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

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Altera as permissões de acesso para a pasta de trabalho. Isso pode exigir que uma versão atualizada seja carregada do 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)

Parâmetros

mode: XlFileAccess

Um dos valores de XlFileAccess. Especifica o novo modo de acesso.

writePassword: Object

Especifica a senha reservada para gravação se o arquivo for reservado para gravação e Mode for xlReadWrite. Ignorado se não houver senha para o arquivo ou se Mode for xlReadOnly.

notify: Object

true para notificar o usuário se o arquivo não puder ser acessado imediatamente.

Exemplos

O exemplo de código a seguir exibe uma mensagem se a ReadOnlyRecommended propriedade é true e a ReadOnly propriedade é falsee solicita que o usuário defina o acesso ao arquivo como somente leitura chamando o ChangeFileAccess método .

Este exemplo destina-se a uma personalização no nível de 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

Comentários

Se você tiver um arquivo aberto no modo somente leitura, não terá acesso exclusivo ao arquivo. Se você alterar um arquivo de somente leitura para leitura/gravação, o Microsoft Office Excel deverá carregar uma nova cópia do arquivo para garantir que nenhuma alteração tenha sido feita enquanto o arquivo estava aberto como somente leitura.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Aplica-se a

Compartilhar via