Como: ler e gravar propriedades de documento

Artigo
02/25/2013

Você pode armazenar propriedades de documento juntamente com um documento.Os aplicativos do Office fornecem um número de propriedades internos, como o autor, título, e assunto.Este tópico mostra como definir propriedades de documento Microsoft Office Excel e Microsoft Office Word.

link para vídeo Para uma demonstração de vídeo relacionada, consulte Como: eu faço Acessar e manipular propriedades personalizadas do documento no Microsoft Word?.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para os seguintes aplicativos: Excel 2013 e Excel 2010; PowerPoint 2013 e PowerPoint 2010; Project 2013 e Project 2010; Word 2013 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Definindo propriedades de documento do excel

Para trabalhar com propriedades internas do excel, use as propriedades a seguir:

Em um projeto de um documento nível, use a propriedade de BuiltinDocumentProperties da classe de ThisWorkbook .
Em um projeto de aplicativo, use a propriedade de BuiltinDocumentProperties de um objeto de Microsoft.Office.Interop.Excel.Workbook .

Essas propriedades retornam um objeto de DocumentProperties , que é uma coleção de objetos de DocumentProperty .Você pode usar a propriedade de Item de coleção por nome para recuperar uma propriedade específica, ou pelo índice dentro da coleção.

O exemplo de código a seguir mostra como modificar a propriedade interna de Revision Number em um projeto de um documento nível.

Para alterar a propriedade número de revisão do excel

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"];

incrementar a propriedade de Revision Number por uma.

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

Definindo propriedades de documento no word

Para trabalhar com propriedades internas em palavras, use as propriedades a seguir:

Em um projeto de um documento nível, use a propriedade de BuiltInDocumentProperties da classe de ThisDocument .
Em um projeto de aplicativo, use a propriedade de BuiltInDocumentProperties de um objeto de Microsoft.Office.Interop.Word.Document .

O exemplo de código a seguir mostra como modificar a propriedade interna de Subject em um projeto de um documento nível.

para alterar a propriedade sujeita

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;

Altere a propriedade de Subject para “artigo”.

' 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ê escreveu o código na classe de ThisWorkbook em um projeto da nível do excel, e a classe de ThisDocument em um projeto de nível para a palavra.

Embora você está trabalhando com palavras e o excel e seus objetos, fontes do Microsoft Office a lista de propriedades internos disponíveis do documento.Tentar acessar uma propriedade indefinido gera uma exceção.