Worksheet.Protect (Método)
Ensamblado: Microsoft.Office.Tools.Excel (en microsoft.office.tools.excel.dll)
public virtual void Protect ( [OptionalAttribute] Object Password, [OptionalAttribute] Object DrawingObjects, [OptionalAttribute] Object Contents, [OptionalAttribute] Object Scenarios, [OptionalAttribute] Object UserInterfaceOnly, [OptionalAttribute] Object AllowFormattingCells, [OptionalAttribute] Object AllowFormattingColumns, [OptionalAttribute] Object AllowFormattingRows, [OptionalAttribute] Object AllowInsertingColumns, [OptionalAttribute] Object AllowInsertingRows, [OptionalAttribute] Object AllowInsertingHyperlinks, [OptionalAttribute] Object AllowDeletingColumns, [OptionalAttribute] Object AllowDeletingRows, [OptionalAttribute] Object AllowSorting, [OptionalAttribute] Object AllowFiltering, [OptionalAttribute] Object AllowUsingPivotTables )
Parámetros
- Password
Una contraseña con distinción entre mayúsculas y minúsculas para la hoja de cálculo. Si se omite este argumento, puede desproteger la hoja de cálculo sin utilizar una contraseña. De lo contrario, debe especificar la contraseña para desproteger la hoja de cálculo. Si olvida la contraseña, no puede desproteger la hoja de cálculo. Se recomienda guardar una lista con las contraseñas y sus correspondientes nombres de documentos en un lugar seguro.
- DrawingObjects
true para proteger las formas. El valor predeterminado es false.
- Contents
true para proteger el contenido de las celdas bloqueadas. El valor predeterminado es true.
- Scenarios
true para proteger los escenarios. El valor predeterminado es true.
- UserInterfaceOnly
true para proteger la interfaz de usuario, pero no las macros. Si se omite este argumento, la protección se aplica tanto a las macros como a la interfaz de usuario.
- AllowFormattingCells
true permite al usuario dar formato a cualquier celda de una hoja de cálculo protegida. El valor predeterminado es false.
- AllowFormattingColumns
true permite al usuario dar formato a cualquier columna de una hoja de cálculo protegida. El valor predeterminado es false.
- AllowFormattingRows
true permite al usuario dar formato a cualquier fila de una hoja de cálculo protegida. El valor predeterminado es false.
- AllowInsertingColumns
true permite al usuario insertar columnas en la hoja de cálculo protegida. El valor predeterminado es false.
- AllowInsertingRows
true permite al usuario insertar filas en la hoja de cálculo protegida. El valor predeterminado es false.
- AllowInsertingHyperlinks
true permite al usuario insertar hipervínculos en la hoja de cálculo. El valor predeterminado es false.
- AllowDeletingColumns
true permite al usuario eliminar columnas en la hoja de cálculo protegida; se desbloquean las celdas de la columna que se va a eliminar. El valor predeterminado es false.
- AllowDeletingRows
true permite al usuario eliminar filas en la hoja de cálculo protegida; se desbloquean las celdas de la fila que se va a eliminar. El valor predeterminado es false.
- AllowSorting
true permite al usuario ordenar en la hoja de cálculo protegida. Se deben desbloquear o desproteger las celdas del rango de ordenación. El valor predeterminado es false.
- AllowFiltering
true permite al usuario establecer filtros en la hoja de cálculo protegida. Los usuarios pueden cambiar los criterios de filtro pero no pueden habilitar o deshabilitar un autofiltro. Los usuarios pueden establecer filtros en un autofiltro existente. El valor predeterminado es false.
- AllowUsingPivotTables
true permite al usuario utilizar informes de tabla dinámica en la hoja de cálculo protegida. El valor predeterminado es false.
Si aplica este método con el argumento UserInterfaceOnly establecido en true y, a continuación, guarda el libro, cuando lo vuelva a abrir se protegerá la hoja de cálculo completa (no sólo la interfaz). Para volver a habilitar la protección de interfaz de usuario después de abrir el libro, debe volver a aplicar este método con UserInterfaceOnly establecido en true.
Es posible realizar cambios en una hoja de cálculo protegida si se proporciona la contraseña. Otro método consistiría en desproteger la hoja de cálculo, realizar los cambios necesarios y, a continuación, volver a proteger la hoja de cálculo.
 Nota |
|---|
| El término "desprotegido" significa que la celda puede estar bloqueada (cuadro de diálogo Formato de celdas) pero está incluida en un rango definido en el cuadro de diálogo Permitir que los usuarios modifiquen rangos, y el usuario ha desprotegido el rango con una contraseña o lo ha validado a través de los permisos de NT. |
Parámetros opcionales
Para obtener información sobre los parámetros opcionales, vea Comprender los parámetros opcionales en interoperabilidad COM.
El ejemplo de código siguiente obtiene el valor de la propiedad ProtectContents para determinar si el contenido de la hoja de cálculo está protegido. Si el contenido no está protegido, se llama al método Protect con el parámetro Contents establecido en true para proteger el contenido.
private void ProtectCellContents() { if (!this.ProtectContents) { if (DialogResult.Yes == MessageBox.Show("Cell contents in this " + "worksheet are not protected. Protect cell contents?", "Example", MessageBoxButtons.YesNo)) { // Protect cell contents, but do not change any // other protection type. this.Protect(missing, this.ProtectDrawingObjects, true, this.ProtectScenarios, this.ProtectionMode, this.Protection.AllowFormattingCells, this.Protection.AllowFormattingColumns, this.Protection.AllowFormattingRows, this.Protection.AllowInsertingColumns, this.Protection.AllowInsertingRows, this.Protection.AllowInsertingHyperlinks, this.Protection.AllowDeletingColumns, this.Protection.AllowDeletingRows, this.Protection.AllowSorting, this.Protection.AllowFiltering, this.Protection.AllowUsingPivotTables); } } }
