Método ChartSheetBase.Protect
Protege Microsoft.Office.Tools.Excel.ChartSheetBase de modo que não pode ser modificado.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintaxe
'Declaração
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
)
Parâmetros
- password
Tipo: System.Object
Uma cadeia de caracteres que especifica uma senha com diferenciação de maiúsculas e minúsculas para a planilha ou pasta de trabalho.Se esse argumento é omitido, você pode unprotect a planilha ou pasta de trabalho sem usar uma senha.Caso contrário, você deve especificar a senha para o unprotect a planilha ou pasta de trabalho.Se você esquece a senha, você não pode unprotect a planilha ou pasta de trabalho.É uma boa ideia manter uma lista das senhas e seus nomes de documento correspondentes em um local seguro.
- drawingObjects
Tipo: System.Object
true para proteger formas.O valor padrão é false.
- contents
Tipo: System.Object
true para proteger conteúdo.Para um gráfico, isso protege o gráfico inteiro.Para uma planilha, isso protege as células bloqueados.O valor padrão é true.
- scenarios
Tipo: System.Object
true para proteger cenários.Esse argumento é válido somente para planilhas.O valor padrão é true.
- userInterfaceOnly
Tipo: System.Object
true para proteger a interface do usuário, mas não macros.Caso esse argumento seja omitido, a proteção se aplica a macros e à interface do usuário.
Comentários
Use senhas seguras que combinam a parte superior e letras minúsculas, números, e os símbolos. Senhas fracas não combinam esses elementos. Senha forte: Y6dh!et5. Senha fraca: House27. Use uma senha forte da qual você possa se lembrar a ponto de não precisar anotá-la.
Parâmetros Opcionais
Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.
Exemplos
O exemplo de código usa o método de Protect para proteger todos os conteúdo de Microsoft.Office.Tools.Excel.ChartSheetBaseatual. O exemplo usa a propriedade de ProtectContents para verificar que a folha de gráfico é protegida, e solicita o usuário para remover a proteção de folha de gráfico usando o método 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(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();
}
}
}
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.