Perguntas Frequentes
Licenciamento & Código Aberto
Qual é o modelo de licenciamento para Aspose.Words FOSS para .NET?
Aspose.Words FOSS for .NET é lançado sob a MIT License. Você pode usá-lo em projetos pessoais, comerciais e de código fechado gratuitamente, sem royalties e sem necessidade de chave de licença em tempo de execução ou etapa de ativação — você só precisa manter o aviso de direitos autorais e o texto da licença em qualquer cópia do software que distribuir.
Como esta edição FOSS difere do produto comercial Aspose.Words para .NET?
Aspose.Words FOSS para .NET não é uma reescrita ou um wrapper — é o Aspose.Words real para o código-fonte .NET, reduzido a um núcleo gratuito e de código aberto. Ele expõe o mesmo Document Object Model do produto comercial (Document, DocumentBuilder, Section, Paragraph, Run, Table, e classes relacionadas), mas omite o subsistema de layout de página e renderização, vários formatos legados e de documentos abertos, execução de mala direta, LINQ Reporting, comparação de documentos e subset de fontes incorporadas. Assinaturas digitais podem ser verificadas, mas não criadas. Consulte as perguntas de formato e limitações abaixo para detalhes. Desenvolvedores que precisam do conjunto completo de recursos podem usar Aspose.Words para .NET junto a esses recursos de código aberto.
Instalação & Requisitos
Como instalo Aspose.Words FOSS para .NET?
A biblioteca está disponível via NuGet ou compilando a partir do código-fonte. Clone o repositório e compile a solução na configuração Release, então adicione uma referência de projeto a Aspose.Words.csproj a partir da sua própria aplicação:
git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c ReleaseQuais versões do .NET e sistemas operacionais são suportados?
A biblioteca tem como alvo o .NET Standard 2.0, portanto funciona no .NET Framework 4.6.2+ e no .NET 6/8/10, em Windows, Linux e macOS. É um C# totalmente gerenciado sem dependências nativas, portanto não é necessário instalar pacotes de sistema adicionais.
Suporte a Formatos
Quais formatos de arquivo Aspose.Words FOSS para .NET pode ler e escrever?
| Formato | Load | Save |
|---|---|---|
| DOCX | Sim | Sim |
| DOCM | Sim | Sim |
| DOTX | Sim | Sim |
| DOTM | Sim | Sim |
| Flat OPC (com macro habilitado e variantes de modelo) | Sim | Sim |
| Markdown | Sim | Sim |
| Texto simples | Sim | Sim |
DOCX, DOCM, DOTX, DOTM e Flat OPC compartilham o mesmo leitor/escritor OOXML.
Posso carregar ou salvar arquivos DOC, RTF, ODT, HTML ou EPUB?
Não. A lista de formatos desta edição termina em DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown e texto simples — .doc, .rtf, .odt, .html e .epub estão fora dessa lista, e abrir qualquer desses arquivos gera uma exceção.
É possível que Aspose.Words FOSS para .NET exporte documentos para PDF, XPS ou formatos de imagem?
Não. Esta edição não inclui o subsistema de layout de página e renderização, portanto Document.Save() não pode exportar para PDF, XPS ou formatos de imagem.
Salve como DOCX, DOCM, DOTX, DOTM, Flat OPC, Markdown ou texto simples. O Aspose.Words comercial para .NET adiciona PDF, XPS e formatos de imagem.
API Usage
Como criar um novo documento?
Construa um Document, envolva-o em um DocumentBuilder e use os métodos de alto nível do construtor para inserir conteúdo antes de salvar:
using Aspose.Words;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.Writeln("Hello, Aspose.Words FOSS!");
doc.Save("output.docx");Como carregar um documento DOCX existente?
Passe o caminho do arquivo para o construtor Document: new Document("input.docx"). O mesmo construtor também aceita um Stream, e ambos possuem sobrecargas que recebem um objeto LoadOptions para controle mais fino de como o arquivo é analisado.
Como os campos como DATE ou DOCPROPERTY são atualizados?
Aspose.Words FOSS for .NET inclui um mecanismo completo de avaliação de campos, portanto campos de conteúdo como DATE, DOCPROPERTY, REF, SEQ e campos de mala direta são atualizados programaticamente. Campos que dependem do layout da página — como números de página em um índice — avaliam para um placeholder 0 em vez de um valor calculado, porque esta edição não inclui o motor de layout que normalmente paginaria o documento.
Limitações Conhecidas
Esta edição suporta a execução de mala direta, LINQ Reporting ou a comparação de documentos?
Não. A execução de mala direta, LINQ Reporting, comparação de documentos e subsetting de fontes incorporadas não estão incluídos nesta edição FOSS. As classes que modelam as configurações e campos de mala direta (por exemplo MailMergeSettings) estão presentes no modelo de objetos, mas a execução de uma mesclagem real não faz parte desta edição.
O Aspose.Words FOSS para .NET pode criar uma assinatura digital em um documento?
Não. Esta edição pode inspecionar e verificar assinaturas digitais já anexadas a um arquivo .docx — através de Document.DigitalSignatures, DigitalSignatureUtil.LoadSignatures() e das classes DigitalSignature/DigitalSignatureCollection — mas não pode criar novas assinaturas. Um fluxo de assinatura requer o Aspose.Words comercial para .NET.
O subsetting de fontes incorporadas é suportado?
Não. Quando EmbedTrueTypeFonts está habilitado, as fontes são incorporadas como arquivos completos em vez de serem subconjuntos apenas dos glifos realmente usados no documento.
