ChartSheet.Unprotect - метод

Статья
08/11/2011

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

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

Синтаксис

'Декларация
Sub Unprotect ( _
    Password As Object _
)

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);
        }
    }
}

Безопасность платформы .NET Framework

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

См. также

Ссылки

ChartSheet Интерфейс

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

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