ChartSheet.Protect Метод (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 Protect ( _
    Password As Object, _
    DrawingObjects As Object, _
    Contents As Object, _
    Scenarios As Object, _
    UserInterfaceOnly As Object _
)
'Применение
Dim instance As ChartSheet
Dim Password As Object
Dim DrawingObjects As Object
Dim Contents As Object
Dim Scenarios As Object
Dim UserInterfaceOnly As Object

instance.Protect(Password, DrawingObjects, _
    Contents, Scenarios, UserInterfaceOnly)

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

Разрешения

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

См. также

Ссылки

ChartSheet Класс

ChartSheet - члены

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

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