Método WorkbookBase.ChangeFileAccess

Artigo
01/09/2014

Altera as permissões de acesso para a pasta de trabalho. Isso pode exigir uma versão atualizada ser carregado no 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
Um dos valores de XlFileAccess.Especifica o novo modo de acesso.

writePassword
Tipo: System.Object
Especifica a senha gravação permissão se o arquivo é permitida e gravação Mode é xlReadWrite.Ignorado se não houver nenhuma 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 imediatamente acessado.

Comentários

Se você tiver um arquivo aberto no modo somente leitura, você não tem acesso exclusivo para o arquivo. Se você alterar um arquivo de somente leitura para leitura/gravação, Microsoft Office Excel deve carregar uma nova cópia do arquivo para certificar-se de que nenhuma alteração é feita quando você tem o arquivo aberto como somente leitura.

Parâmetros Opcionais

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

Exemplos

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

Este exemplo destina-se a uma personalização no 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,
                 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ável.

Consulte também

Referência

WorkbookBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via