WorkbookBase.ChangeFileAccess (Método)
Cambia los permisos de acceso del libro.Esto podría exigir que se cargue una versión actualizada desde el disco.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel.v4.0.Utilities (en Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintaxis
'Declaración
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
Uno de los valores de XlFileAccess.Especifica el nuevo modo de acceso.
- writePassword
Tipo: System.Object
Especifica la contraseña de reservado para escritura si el archivo está reservado para escritura y Mode es xlReadWrite.Se omite si no existe ninguna contraseña para el archivo o si Mode es xlReadOnly.
- notify
Tipo: System.Object
true para avisar al usuario si no se puede tener acceso al archivo inmediatamente.
Comentarios
Si el usuario ha abierto un archivo en modo de sólo lectura, no tiene acceso exclusivo al archivo.Si cambia un archivo de sólo lectura a lectura/escritura, Microsoft Office Excel debe cargar una nueva copia del archivo para garantizar que no se ha efectuado ningún cambio en el archivo mientras estaba abierto en modo de sólo lectura.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
El ejemplo de código siguiente muestra un mensaje si la propiedad ReadOnlyRecommended es true y la propiedad ReadOnly es false y, a continuación, solicita al usuario que establezca el acceso al archivo en modo de sólo lectura llamando al método ChangeFileAccess.
Se trata de un ejemplo para una personalización en el nivel del 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);
}
}
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.