WorkbookBase.Protect-Methode
Schützt eine Arbeitsmappe, sodass sie nicht geändert werden kann.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Syntax
'Declaration
Public Sub Protect ( _
password As Object, _
structure As Object, _
windows As Object _
)
public void Protect(
Object password,
Object structure,
Object windows
)
Parameter
- password
Typ: System.Object
Ein Kennwort für die Arbeitsmappe, bei dem die Groß-/Kleinschreibung beachtet wird.Wenn dieses Argument ausgelassen wird, können Sie den Schutz für die Arbeitsmappe ohne Kennwort aufheben.Andernfalls müssen Sie das Kennwort angeben, um den Schutz für die Arbeitsmappe aufzuheben.
- structure
Typ: System.Object
true, um die Anordnung der Arbeitsmappe (die relative Position der Blätter) zu schützen.Der Standardwert ist false.
- windows
Typ: System.Object
true, um die Arbeitsmappenfenster zu schützen.Wenn dieses Argument ausgelassen wird, werden die Fenster nicht geschützt.
Hinweise
Verwenden Sie sichere Kennwörter, die aus Groß- und Kleinbuchstaben, Zahlen und Symbolen bestehen. In unsicheren Kennwörtern sind diese Elemente nicht kombiniert. Zum Beispiel ist "Y6dh!et5" ein sicheres Kennwort, und "Haus27" ist ein unsicheres Kennwort. Verwenden Sie ein sicheres Kennwort, das Sie sich leicht merken können, damit Sie es nicht aufschreiben müssen.
Optionale Parameter
Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.
Beispiele
Im folgenden Codebeispiel wird mithilfe der Protect-Methode die Anordnung der Arbeitsmappe und der Arbeitsmappenfenster ohne Kennwortschutz geschützt. Anschließend werden die Werte der ProtectStructure-Eigenschaft und der ProtectWindows-Eigenschaft überprüft, um sicherzustellen, dass der Schutz festgelegt wurde.
Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.
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.");
}
}
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.