Freigeben über

ChartSheet.Protect-Methode

  • Artikel

Schützt ein Microsoft.Office.Tools.Excel.ChartSheet, sodass es nicht geändert werden kann.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
Sub Protect ( _
    Password As Object, _
    DrawingObjects As Object, _
    Contents As Object, _
    Scenarios As Object, _
    UserInterfaceOnly As Object _
)

void Protect(
    Object Password,
    Object DrawingObjects,
    Object Contents,
    Object Scenarios,
    Object UserInterfaceOnly
)

Parameter

  • Password
    Typ: System.Object
    Eine Zeichenfolge, die ein Kennwort (mit Beachtung von Groß- und Kleinschreibung) für das Arbeitsblatt oder die Arbeitsmappe angibt.Wenn dieses Argument ausgelassen wird, kann der Schutz von Arbeitsblatt oder Arbeitsmappe aufgehoben werden, ohne ein Kenwort zu verwenden.Andernfalls müssen Sie das Kennwort angeben, um den Schutz für das Arbeitsblatt oder die Arbeitsmappe aufzuheben.Wenn Sie das Kennwort vergessen, können Sie den Schutz für das Arbeitsblatt oder die Arbeitsmappe nicht aufheben.Es empfiehlt sich, eine Liste Ihrer Kennwörter und der entsprechenden Dokumentnamen an einem sicheren Ort aufzubewahren.
  • DrawingObjects
    Typ: System.Object
    true, um Formen zu schützen.Der Standardwert ist false.
  • Contents
    Typ: System.Object
    true, um Inhalte zu schützen.Bei einem Diagramm wird damit das gesamte Diagramm geschützt.Bei einem Arbeitsblatt werden damit die gesperrten Zellen geschützt.Der Standardwert ist true.
  • Scenarios
    Typ: System.Object
    true, um Szenarios zu schützen.Dieses Argument gilt nur für Arbeitsblätter.Der Standardwert ist true.
  • UserInterfaceOnly
    Typ: System.Object
    true, um die Benutzeroberfläche zu schützen, aber keine Makros.Wenn dieses Argument ausgelassen wird, wird der Schutz sowohl auf Makros als auch auf die Benutzeroberfläche angewendet.

Hinweise

Verwenden Sie sichere Kennwörter, die sich aus Groß- und Kleinbuchstaben, Zahlen und Sonderzeichen zusammensetzen. In unsicheren Kennwörtern sind diese Elemente nicht kombiniert. Ein sicheres Kennwort: Y6dh!et5. Ein unsicheres Kennwort: House27. 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 die Protect-Methode verwendet, um den gesamten Inhalt des aktuellen Microsoft.Office.Tools.Excel.ChartSheet zu schützen. Im Beispiel wird anschließend mit der ProtectContents-Eigenschaft überprüft, ob das Diagrammblatt geschützt ist. Der Benutzer wird anschließend aufgefordert, mit der Unprotect-Methode den Schutz für das Diagrammblatt aufzuheben.

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(missing, 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(missing);
        }
    }
}

.NET Framework-Sicherheit

Siehe auch

Referenz

ChartSheet Schnittstelle

Microsoft.Office.Tools.Excel-Namespace