ChartSheetBase.Protect - метод
Защищает объект Microsoft.Office.Tools.Excel.ChartSheetBase от изменений.
Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v4.0.Utilities (в Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Синтаксис
'Декларация
Public Sub Protect ( _
password As Object, _
drawingObjects As Object, _
contents As Object, _
scenarios As Object, _
userInterfaceOnly As Object _
)
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.ChartSheetBase. После этого в примере производится обращение к свойству 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
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.