Como: Ler e gravar em propriedades do documento

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de documento Versão do Microsoft Office Microsoft Office Sistema de 2007 Microsoft Office 2003 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Você pode armazenar propriedades do documento junto com o documento ou pasta de trabalho em personalizações em nível de documento para Microsoft Office Word e Microsoft Office Excel.Excel e Word fornecem um número de propriedades internAmbos, como autor, título, e Ambossunto.

Configuração Documento propriedades no Excel

Use a propriedade BuiltinDocumentProperties da classe ThisWorkbook para trabalhar com propriedades internas.Essa propriedade retorna um objeto de DocumentProperties , que é uma coleção de objetos de DocumentProperty.Você pode usar a propriedade de Item da coleção para recuperar uma propriedade específica, por nome ou por índice dentro da coleção.

Para alterar a propriedade número de revisão no Excel

1. Atribuir Propriedades internas de documento a uma variável.

   Dim properties As Microsoft.Office.Core.DocumentProperties
   
   properties = DirectCast(Globals.ThisWorkbook.BuiltinDocumentProperties, _
       Microsoft.Office.Core.DocumentProperties)
   
   Dim prop As Microsoft.Office.Core.DocumentProperty
   prop = properties.Item("Revision Number")
   

   Microsoft.Office.Core.DocumentProperties properties;
   
   properties = (Microsoft.Office.Core.DocumentProperties)
       Globals.ThisWorkbook.BuiltinDocumentProperties; 
   
   Microsoft.Office.Core.DocumentProperty prop;
   prop = properties["Revision Number"]; 
   

2. Aumentam a propriedade Revision Number em um.

   If prop.Value Is Nothing Then
       prop.Value = 1
   Else
       Dim revision As Integer
       If Integer.TryParse(prop.Value.ToString(), revision) Then
           prop.Value = revision + 1
           MessageBox.Show("Revision Number = " & revision)
       Else
           MessageBox.Show("Revision Number = invalid value")
       End If
   End If
   

   if (prop.Value == null)
   {
       prop.Value = 1;
   }
   else
   {
       int revision;
       if (int.TryParse((string)prop.Value, out revision))
       {
           prop.Value = revision + 1;
           MessageBox.Show("Revision Number = " + revision);
       }
       else
       {
           MessageBox.Show("Revision Number = invalid value");
       }
   }
   

Configuração Documento propriedades no Word

Use a propriedade BuiltInDocumentProperties da classe ThisDocument para trabalhar com propriedades internas.Essa propriedade retorna um objeto de DocumentProperties , que é uma coleção de objetos de DocumentProperty.Você pode usar a propriedade de Item da coleção para recuperar uma propriedade específica, por nome ou por índice dentro da coleção.

Para alterar a propriedade assunto

1. Atribuir Propriedades internas de documento a uma variável.

   Dim properties As Microsoft.Office.Core.DocumentProperties
   
   properties = DirectCast(Globals.ThisDocument.BuiltInDocumentProperties, _
       Microsoft.Office.Core.DocumentProperties)
   

   Microsoft.Office.Core.DocumentProperties properties;
   
   properties = (Microsoft.Office.Core.DocumentProperties)
       Globals.ThisDocument.BuiltInDocumentProperties; 
   

2. Alterar a propriedade Subject "informe oficial".

   ' Set the Subject property.
   properties.Item("Subject").Value = "Whitepaper"
   

   // Set the Subject property. 
   properties["Subject"].Value = "Whitepaper"; 
   

Programação robusta

Os exemplos assumem que você tenha escrito o código na classe ThisWorkbook para o Excel e a classe ThisDocument para Word.

Embora você estiver trabalhando com o Word e Excel e seus objetos, o Microsoft Office fornece a lista de propriedades internas de documento disponíveis.Tentativa de acessar a propriedade Value para propriedades indefinidas gera uma exceção.

Consulte também

Tarefas

Como: Criar e modificar propriedades Personalizars de documentos

Conceitos

Personalizações de nível de documento de programação