Workbook.Protect (Método) (2007 System)

Artículo
09/04/2008

Actualización: noviembre 2007

Protege un libro para que no se pueda modificar.

Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel.v9.0 (en Microsoft.Office.Tools.Excel.v9.0.dll)

Sintaxis

Public Sub Protect ( _
    Password As Object, _
    Structure As Object, _
    Windows As Object _
)

Dim instance As Workbook
Dim Password As Object
Dim Structure As Object
Dim Windows As Object

instance.Protect(Password, Structure, _
    Windows)

public void Protect(
    Object Password,
    Object Structure,
    Object Windows
)

Parámetros

Password
Tipo: System.Object

Una contraseña con distinción entre mayúsculas y minúsculas para el libro. Si se omite este argumento, puede desproteger el libro sin utilizar una contraseña. De lo contrario, debe especificar la contraseña para desproteger el libro.

Structure
Tipo: System.Object

true para proteger la estructura del libro (la posición relativa de las hojas). El valor predeterminado es false.

Windows
Tipo: System.Object

true para proteger las ventanas del libro. Si se omite este argumento, no se protegen las ventanas.

Comentarios

Utilice contraseñas seguras que combinen mayúsculas y minúsculas, números y símbolos. Las contraseñas no seguras no mezclan estos elementos. Por ejemplo, "Y6dh!et5" es una contraseña segura, pero "House27" es una contraseña poco rigurosa. Utilice una contraseña segura que pueda recordar para no tener que apuntarla.

Parámetros opcionales

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

Ejemplos

El ejemplo de código siguiente utiliza el método Protect para proteger la estructura del libro y de las ventanas de libro, sin especificar la protección con contraseña. A continuación, el ejemplo comprueba los valores de las propiedades ProtectStructure y ProtectWindows para comprobar que se ha establecido esta protección.

Se trata de un ejemplo para una personalización en el nivel del documento.

Private Sub ProtectWorkbook()
    Me.Protect(Structure:=True, Windows:=True)

    If Me.ProtectStructure Then
        MsgBox("You cannot add, delete or change the location " & _
            "of sheets in this workbook.")
    End If

    If Me.ProtectWindows Then
        MsgBox("You cannot arrange windows in this workbook.")
    End If
End Sub

private void ProtectWorkbook()
{
    this.Protect(missing, true, true);

    if (this.ProtectStructure)
    {
        MessageBox.Show("You cannot add, delete or change the location " +
            "of sheets in this workbook.");
    }

    if (this.ProtectWindows)
    {
        MessageBox.Show("You cannot arrange windows in this workbook.");
    }
}

Permisos

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.

Vea también

Referencia

Workbook (Clase)

Workbook (Miembros)

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

Share via