Como: Ler e gravar propriedades de documento

Artigo
08/08/2011

Você pode armazenar documento propriedades juntamente com um documento em que os aplicativos de Microsoft Office listadas acima. Esses aplicativos fornecem um número de propriedades internas, como autor, título e assunto. Este tópico mostra como definir propriedades de documento no Excel de Microsoft Office e Microsoft Office o Word.

link para vídeo Para uma demonstração de vídeo relacionada, consulte Fazer como i: Acessar e manipular as propriedades personalizadas de documentos 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 2007 e Excel 2010; PowerPoint 2007 e PowerPoint 2010; Project 2007 e Project 2010; Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Definir propriedades de documento no Excel

Para trabalhar com propriedades internas no Excel, use as seguintes propriedades:

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

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

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

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

Atribua propriedades internas do 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"];

Incremento de Revision Number propriedade por 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");
    }
}

Definir propriedades de documento no Word

Para trabalhar com propriedades internas do Word, use as seguintes propriedades:

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

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

Para alterar a propriedade Subject

Atribua propriedades internas do 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;

Alterar o Subject a propriedade "White paper".

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

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

Programação robusta

Os exemplos pressupõem que você tenha escrito o código ThisWorkbook a classe em um projeto de nível de documento do Excel e o ThisDocument classe em um projeto de nível de documento para Word.

Embora você estiver trabalhando com o Word e Excel e seus objetos, o Microsoft Office fornece a lista de propriedades internas do documento disponível. A tentativa de acessar uma propriedade indefinida gerará uma exceção.