As propriedades do documento ou metadados em arquivos do PowerPoint são usados para identificação das apresentações. Além disso, eles fornecem informações adicionais sobre a apresentação, como autor, título, palavras-chave, assunto, etc. Neste artigo, você aprenderá como acessar ou modificar as propriedades em arquivos do PowerPoint programaticamente usando C#.
- API .NET para acessar/modificar propriedades em arquivos do PowerPoint
- Tipos de propriedades em apresentações do PowerPoint
- Acessar propriedades internas em apresentações do PowerPoint
- Modificar propriedades internas em apresentações do PowerPoint
- Adicionar propriedades personalizadas em apresentações do PowerPoint
- Acessar Propriedades Personalizadas em Apresentações do PowerPoint
- Modificar propriedades personalizadas em apresentações do PowerPoint
API .NET para acessar/modificar propriedades em arquivos do PowerPoint
Para acessar ou modificar as propriedades internas ou personalizadas do documento, usaremos Aspose.Slides for .NET. É uma API poderosa para criar e manipular documentos PowerPoint e OpenOffice. A API está disponível como uma DLL para download, bem como em NuGet.
PM> Install-Package Aspose.Slides.NET
Tipos de propriedades em apresentações do PowerPoint
As apresentações do PowerPoint oferecem suporte a dois tipos de propriedades do documento: internas e personalizadas. As propriedades internas fornecem informações gerais sobre as apresentações, como título, autor, assunto, etc. Já as propriedades personalizadas são definidas pelos usuários na forma de pares chave/valor. As seções a seguir demonstram como adicionar, acessar e modificar propriedades pertencentes a cada um dos tipos mencionados acima.
Acesse propriedades internas em apresentações do PowerPoint usando C#
A seguir estão as etapas para acessar as propriedades internas em apresentações do PowerPoint usando C#.
- Carregue a apresentação do PowerPoint usando a classe Apresentação.
- Acesse as propriedades internas em um objeto IDocumentProperties da propriedade Presentation.DocumentProperties.
- Leia cada propriedade interna na apresentação usando o objeto IDocumentProperties, como IDocumentProperties.Author.
O exemplo de código a seguir mostra como acessar propriedades internas em apresentações do PowerPoint.
// Carregar apresentação
Presentation pres = new Presentation("AccessBuiltin Properties.pptx");
// Crie uma referência ao objeto IDocumentProperties associado à Apresentação
IDocumentProperties documentProperties = pres.DocumentProperties;
// Exibir as propriedades internas
System.Console.WriteLine("Category : " + documentProperties.Category);
System.Console.WriteLine("Current Status : " + documentProperties.ContentStatus);
System.Console.WriteLine("Creation Date : " + documentProperties.CreatedTime);
System.Console.WriteLine("Author : " + documentProperties.Author);
System.Console.WriteLine("Description : " + documentProperties.Comments);
System.Console.WriteLine("KeyWords : " + documentProperties.Keywords);
System.Console.WriteLine("Last Modified By : " + documentProperties.LastSavedBy);
System.Console.WriteLine("Supervisor : " + documentProperties.Manager);
System.Console.WriteLine("Modified Date : " + documentProperties.LastSavedTime);
System.Console.WriteLine("Presentation Format : " + documentProperties.PresentationFormat);
System.Console.WriteLine("Last Print Date : " + documentProperties.LastPrinted);
System.Console.WriteLine("Is Shared between producers : " + documentProperties.SharedDoc);
System.Console.WriteLine("Subject : " + documentProperties.Subject);
System.Console.WriteLine("Title : " + documentProperties.Title);
Modificar propriedades internas em apresentações do PowerPoint usando C#
A seguir estão as etapas para modificar os valores das propriedades internas em apresentações do PowerPoint usando C#.
- Primeiro, carregue a apresentação do PowerPoint usando a classe Apresentação.
- Em seguida, obtenha a referência das propriedades internas em um objeto IDocumentProperties da propriedade Presentation.DocumentProperties.
- Modifique a propriedade interna desejada na apresentação usando o objeto IDocumentProperties, como IDocumentProperties.Author.
- Finalmente, salve a apresentação usando o método Presentation.Save(String, SaveFormat).
O exemplo de código a seguir mostra como modificar as propriedades internas em apresentações do PowerPoint.
// Carregar apresentação
Presentation presentation = new Presentation("ModifyBuiltinProperties.pptx");
// Crie uma referência ao objeto IDocumentProperties associado à Apresentação
IDocumentProperties documentProperties = presentation.DocumentProperties;
// Defina as propriedades internas
documentProperties.Author = "Aspose.Slides for .NET";
documentProperties.Title = "Modifying Presentation Properties";
documentProperties.Subject = "Aspose Subject";
documentProperties.Comments = "Aspose Description";
documentProperties.Manager = "Aspose Manager";
// Salve sua apresentação em um arquivo
presentation.Save("DocumentProperties_out.pptx", SaveFormat.Pptx);
Adicionar propriedades personalizadas em apresentações do PowerPoint usando C#
A seguir estão as etapas para adicionar propriedades personalizadas em uma apresentação do PowerPoint usando C#.
- Primeiro, carregue a apresentação do PowerPoint usando a classe Apresentação.
- Em seguida, obtenha a referência das propriedades do documento em um objeto IDocumentProperties da propriedade Presentation.DocumentProperties.
- Adicione uma propriedade personalizada definindo sua chave e valor, por exemplo, IDocumentProperties[“Key”] = “Value”.
- Finalmente, salve a apresentação usando o método Presentation.Save(String, SaveFormat).
O exemplo de código a seguir mostra como adicionar propriedades personalizadas em uma apresentação do PowerPoint.
// Carregar apresentação
Presentation presentation = new Presentation("Presentation.pptx");
// Obter referência de propriedades do documento
IDocumentProperties documentProperties = presentation.DocumentProperties;
// Adicionar propriedades personalizadas
documentProperties["New Custom"] = 12;
documentProperties["My Name"] = "Mudassir";
documentProperties["Custom"] = 124;
// Salvar apresentação
presentation.Save("CustomDocumentProperties_out.pptx", SaveFormat.Pptx);
Acesse propriedades personalizadas em apresentações do PowerPoint usando C#
As etapas a seguir demonstram como acessar as propriedades personalizadas em uma apresentação do PowerPoint usando C#.
- Primeiro, carregue a apresentação do PowerPoint usando a classe Apresentação.
- Obtenha a referência das propriedades do documento em um objeto IDocumentProperties da propriedade Presentation.DocumentProperties.
- Acesse cada propriedade personalizada usando o método IDocumentProperties.GetCustomPropertyName(int32 index) em um loop.
O exemplo de código a seguir mostra como acessar propriedades personalizadas em uma apresentação do PowerPoint.
// Carregar apresentação
Presentation presentation = new Presentation("Presentation.pptx");
// Obter referência de propriedades do documento
IDocumentProperties documentProperties = presentation.DocumentProperties;
// Acesse propriedades personalizadas
for (int i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
// Exibir nomes e valores de propriedades personalizadas
System.Console.WriteLine("Custom Property Name : " + documentProperties.GetCustomPropertyName(i));
System.Console.WriteLine("Custom Property Value : " + documentProperties[documentProperties.GetCustomPropertyName(i)]);
}
Modificar propriedades personalizadas em apresentações do PowerPoint usando C#
A seguir estão as etapas para modificar as propriedades personalizadas em uma apresentação do PowerPoint.
- Primeiro, carregue a apresentação do PowerPoint usando a classe Apresentação.
- Em seguida, obtenha a referência das propriedades do documento em um objeto IDocumentProperties da propriedade Presentation.DocumentProperties.
- Acesse cada propriedade personalizada usando o método IDocumentProperties.GetCustomPropertyName(int32 index) em um loop.
- Modifique o valor de uma propriedade especificando sua chave na matriz IDocumentProperties[IDocumentProperties.GetCustomPropertyName(int index)].
- Finalmente, salve a apresentação usando o método Presentation.Save(String, SaveFormat).
O exemplo de código a seguir mostra como modificar uma propriedade personalizada em uma apresentação do PowerPoint.
// Carregar apresentação
Presentation presentation = new Presentation("Presentation.pptx");
// Obter referência de propriedades do documento
IDocumentProperties documentProperties = presentation.DocumentProperties;
// Acesse e modifique propriedades personalizadas
for (int i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
// Modificar valores de propriedades personalizadas
documentProperties[documentProperties.GetCustomPropertyName(i)] = "New Value " + (i + 1);
}
// Salvar apresentação
presentation.Save("CustomDocumentProperties_out.pptx", SaveFormat.Pptx);
Obtenha uma licença de API gratuita
Você pode usar o Aspose.Slides para .NET sem limitações de avaliação solicitando uma licença temporária.
Demonstração on-line
Você também pode tentar a ferramenta online para visualizar e editar as propriedades do documento em apresentações, que é baseado em Aspose.Slides.
Você também pode experimentar o Aspose editor de PowerPoint online gratuito.
Conclusão
Neste artigo, você aprendeu como adicionar, acessar e modificar propriedades de documentos em apresentações do PowerPoint usando C#. O artigo abordou explicitamente a manipulação de propriedades de documento internas e personalizadas. Além disso, você pode visitar a documentação para explorar mais sobre o Aspose.Slides para .NET. Além disso, você pode postar suas dúvidas em nosso fórum.
Veja também
- Criar apresentações do MS PowerPoint em C#
- Converter PowerPoint PPTX/PPT para imagens PNG em C#
- Definir plano de fundo do slide em apresentações do PowerPoint usando C#
- Gerar miniaturas para PowerPoint PPTX ou PPT usando C#
- Aplicar animação ao texto no PowerPoint usando C#
- Dividir apresentações do PowerPoint usando C#