ChartSheet.Unprotect Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Снимает защиту с объекта Microsoft.Office.Tools.Excel.ChartSheet. Если на листе или в книге отсутствует защита, этот метод не работает.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
Public Sub Unprotect ( _
    Password As Object _
)
'Применение
Dim instance As ChartSheet
Dim Password As Object

instance.Unprotect(Password)

public void Unprotect(
    Object Password
)

Параметры

Password
Тип: System.Object
Пароль с учетом регистра, используемый для снятия защиты с листа или книги. Если лист или книга не защищены паролем, этот аргумент игнорируется. Если книга защищена с помощью пароля и этот аргумент опущен, пользователю предлагается ввести пароль. Если опустить этот аргумент для книги с защитой паролем, происходит сбой метода.

Заметки

Если пароль утерян, снять защиту с объекта Microsoft.Office.Tools.Excel.ChartSheet будет невозможно. Список паролей и соответствующие имена документов следует хранить в надежном месте.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях Office.

Примеры

В следующем примере кода вызывается метод Protect для защиты всего содержимого текущего объекта Microsoft.Office.Tools.Excel.ChartSheet. После этого в примере производится обращение к свойству ProtectContents для проверки наличия защиты листа диаграммы, а затем выдается запрос пользователю на снятие защиты листа диаграммы, которое осуществляется с помощью метода 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(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);
                }
            }
        }

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

ChartSheet Класс

ChartSheet - члены

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через