Método WorkbookBase.ChangeFileAccess

Artigo
08/01/2011

Altera as permissões de acesso da pasta de trabalho. Isso pode requerer uma versão atualizada seja carregada do disco.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public Sub ChangeFileAccess ( _
    mode As XlFileAccess, _
    writePassword As Object, _
    notify As Object _
)

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

Parâmetros

mode
Tipo: Microsoft.Office.Interop.Excel.XlFileAccess
Dentre as XlFileAccess valores.Especifica o novo modo de acesso.

writePassword
Tipo: System.Object
Especifica a senha de gravação reservada se o arquivo está protegido contra gravação e Mode é xlReadWrite.Ignorado se houver uma senha para o arquivo ou se Mode é xlReadOnly.

notify
Tipo: System.Object
true para notificar o usuário se o arquivo não pode ser acessado imediatamente.

Comentários

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

Optional Parameters

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

Exemplos

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

Este exemplo é para uma personalização em nível de 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);
        }
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

WorkbookBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via