ChartSheet.Protect - метод

Статья
08/11/2011

Защищает объект Microsoft.Office.Tools.Excel.ChartSheet от изменений.

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

Синтаксис

'Декларация
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
)

Параметры

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

DrawingObjects
Тип: System.Object
Значение true для защиты фигур.Значение по умолчанию: false.

Contents
Тип: System.Object
Значение true для защиты содержимого.В случае диаграммы защита применяется ко всей диаграмме.В случае рабочего листа защита применяется к заблокированным ячейкам.Значение по умолчанию: true.

Scenarios
Тип: System.Object
Значение true для защиты скриптов.Данный аргумент допустим только для рабочих листов.Значение по умолчанию: true.

UserInterfaceOnly
Тип: System.Object
Значение true используется для защиты пользовательского интерфейса, но не макросов.Если этот аргумент не указан, защита применяется как к макросам, так и к пользовательскому интерфейсу.

Заметки

Надежный пароль должен состоять из строчных и прописных букв, цифр и символов. Ненадежный пароль не содержит сочетания этих элементов. Надежный пароль: Y6dh!et5. Ненадежный пароль: House27. Надежный пароль должен легко запоминаться, чтобы его не нужно было записывать.

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

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях 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 - пространство имен

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