Compartir a través de

ChartSheetBase.Protect (Método)

  • Artículo

Protege un objeto Microsoft.Office.Tools.Excel.ChartSheetBase para que no se pueda modificar.

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 Protect ( _
    password As Object, _
    drawingObjects As Object, _
    contents As Object, _
    scenarios As Object, _
    userInterfaceOnly As Object _
)

public void Protect(
    Object password,
    Object drawingObjects,
    Object contents,
    Object scenarios,
    Object userInterfaceOnly
)

Parámetros

  • password
    Tipo: System.Object
    Una cadena que especifica una contraseña que distingue entre mayúsculas y minúsculas para la hoja de cálculo o libro.Si se omite este argumento, puede desproteger la hoja de cálculo o el libro sin utilizar una contraseña.De lo contrario, para desproteger la hoja de cálculo o libro debe especificar la contraseña.Si olvida la contraseña, no puede desproteger la hoja de cálculo o el libro.Se recomienda guardar una lista con las contraseñas y sus correspondientes nombres de documentos en un lugar seguro.
  • drawingObjects
    Tipo: System.Object
    true para proteger las formas.El valor predeterminado es false.
  • contents
    Tipo: System.Object
    true para proteger el contenido.Si se trata de un gráfico, este parámetro protege todo el gráfico.En el caso de las hojas de cálculo, protege las celdas bloqueadas.El valor predeterminado es true.
  • scenarios
    Tipo: System.Object
    true para proteger los escenarios.Este argumento es válido sólo para hojas.El valor predeterminado es true.
  • userInterfaceOnly
    Tipo: System.Object
    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.

Comentarios

Utilice contraseñas seguras que combinen letras mayúsculas y minúsculas, números y símbolos.Las contraseñas no seguras no mezclan estos elementos.Contraseña segura: Y6dh!et5.Contraseña no segura: Casa27.Utilice una contraseña segura que pueda recordar para no tener que apuntarla.

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 utiliza el método Protect para proteger todo el contenido del objeto Microsoft.Office.Tools.Excel.ChartSheetBase actual.A continuación, el ejemplo usa la propiedad ProtectContents para comprobar que la hoja del gráfico está protegida y, a continuación, pregunta al usuario si desea quitar la protección de la hoja del gráfico utilizando el método Unprotect.

Private Sub ChartSheetProtection()
    Globals.Sheet1.Range("A1", "A5").Value2 = 22
    Globals.Sheet1.Range("B1", "B5").Value2 = 55

    Me.SetSourceData(Globals.Sheet1.Range("A1", "B5"), _
        Excel.XlRowCol.xlColumns)
    Me.ChartType = Excel.XlChartType.xl3DColumn

    Me.Protect(DrawingObjects:=True, Contents:=True, _
        Scenarios:=True, UserInterfaceOnly:=False)

    If Me.ProtectContents Then
        If DialogResult.Yes = MessageBox.Show("The chart sheet" & _
            " is protected. Unprotect the chart sheet?", _
            "Example", MessageBoxButtons.YesNo) Then
            Me.Unprotect()
        End If
    End If
End Sub

private void ChartSheetProtection()
{
    Globals.Sheet1.Range["A1", "A5"].Value2 = 22;
    Globals.Sheet1.Range["B1", "B5"].Value2 = 55;

    this.SetSourceData(Globals.Sheet1.Range["A1", "B5"],
        Excel.XlRowCol.xlColumns);
    this.ChartType = Excel.XlChartType.xl3DColumn;

    this.Protect(true, true, true, false);

    if (this.ProtectContents)
    {
        if (DialogResult.Yes ==
            MessageBox.Show("The chart sheet is protected. " +
            "Unprotect the chart sheet?", "Example", 
            MessageBoxButtons.YesNo))
        {
            this.Unprotect();
        }
    }
}

Seguridad de .NET Framework

Vea también

Referencia

ChartSheetBase Clase

Microsoft.Office.Tools.Excel (Espacio de nombres)