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

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Excel

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

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Cambia los permisos de acceso del libro. Esto podría exigir que se cargue una versión actualizada desde el 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

Uno de los valores de XlFileAccess. Especifica el nuevo modo de acceso.

writePassword: Object

Especifica la contraseña reservada de escritura si el archivo está reservado y Mode es xlReadWrite. Se omite si no hay ninguna contraseña para el archivo o si Mode es xlReadOnly.

notify: Object

true para avisar al usuario si no se puede tener acceso al archivo inmediatamente.

Ejemplos

En el ejemplo de código siguiente se muestra un mensaje si la ReadOnlyRecommended propiedad es true y la ReadOnly propiedad es falsey, a continuación, se pide al usuario que establezca el acceso de archivo a solo lectura llamando al ChangeFileAccess método .

Este ejemplo es para una personalización de nivel 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

Comentarios

Si tiene un archivo abierto en modo de solo lectura, no tiene acceso exclusivo al archivo. Si cambia un archivo de solo lectura a lectura y escritura, Microsoft Office Excel debe cargar una nueva copia del archivo para asegurarse de que no se realizaron cambios mientras tenía el archivo abierto como de solo lectura.

Parámetros opcionales

Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.

Se aplica a

Compartir a través de