How to Add Image to DOCX in C#

Quais formatos de imagem são suportados?

Formatos de arquivo suportados: .jpg, .png, .bmp, .tiff e .gif. Cada formato mantém sua qualidade quando inserido. O formato JPEG é o mais indicado para fotografias. O PNG suporta transparência para logotipos e gráficos. O formato BMP oferece qualidade sem compressão. O formato TIFF é adequado para documentos de impressão de alta qualidade. O formato GIF permite animações simples (apenas o primeiro quadro é exibido em documentos estáticos).

Onde a imagem será inserida no documento?

Por padrão, as imagens são adicionadas na posição atual do cursor, sem nenhum nó pai. Para um posicionamento preciso, insira imagens como elementos filhos dentro dos parágrafos. Isso proporciona um melhor controle sobre o fluxo do texto e integra as imagens à estrutura do seu documento.

Por que usar a classe ImageContent?

A classe ImageContent gerencia as propriedades da imagem de forma estruturada. Modifique as dimensões, o posicionamento e a formatação antes da inserção. Essa abordagem garante consistência em todo o processo de geração de documentos e aplica regras de formatação padrão em toda a sua aplicação. A classe encapsula todas as propriedades relacionadas à imagem, tornando o código mais fácil de manter e reduzindo erros de formatação.

Quando devo usar o método Stream?

Use o método Stream quando:

• As imagens estão protegidas por APIs seguras que exigem autenticação.
• Processamento dinâmico de imagens a partir da memória
• Trabalhar com imagens armazenadas como dados binários em bancos de dados

Este método funciona bem em aplicações empresariais onde as imagens são armazenadas em sistemas de gestão documental, armazenamento na nuvem ou geradas por serviços de processamento de imagens.

Quais são os benefícios do carregamento de fluxos de dados?

O carregamento de fluxos integra imagens de endpoints autenticados sem salvar arquivos temporários. Isso melhora a segurança e o desempenho. Os benefícios incluem:

• Redução das operações de E/S de disco
• Não há armazenamento em cache de imagens sensíveis no disco.
• Fluxos de trabalho de processamento de imagem em tempo real
• Melhor gerenciamento de memória para imagens grandes
• Opções flexíveis de origem da imagem

Como faço para personalizar a largura e a altura?

Implemente largura e altura personalizadas alterando a proporção da tela. Controle a forma como as imagens aparecem nos documentos, seja mantendo as proporções ou ajustando-as a restrições de layout específicas.

:path=/static-assets/word/content-code-examples/how-to/add-image-custom-size.cs

using IronWord;

// initializing docx file
WordDocument doc = new IronWord.WordDocument();

// instantiating image file
IronWord.Models.ImageContent image = new IronWord.Models.ImageContent("sample-image.tiff");

// modifying the aspect ratio by introducing custom width
image.Width = 800;
image.Height = 200;

// AddImage function saving the image
doc.AddImage(image);

// Save and export the file
doc.SaveAs("custom-size-image.docx");

O que acontece com a proporção da tela?

Valores personalizados de largura e altura substituem a proporção original. Estique ou comprima imagens para adequá-las a requisitos de layout, como cabeçalhos, barras laterais ou contêineres de tamanho fixo. Distorções extremas podem parecer pouco profissionais. Para manter a proporção ao redimensionar, calcule as dimensões proporcionais com base no tamanho desejado.

Quais propriedades devo configurar primeiro?

Defina as propriedades nesta ordem:

1. Dimensões (largura/altura) - base do layout da imagem
2. Posicionamento (Propriedades DistanceFrom) - controle de espaçamento e margens
3. Propriedades avançadas (escala/translação) - ajuste fino

Essa abordagem garante que cada propriedade seja construída logicamente sobre as anteriores. Algumas propriedades interagem — a quebra de texto afeta o funcionamento das propriedades de distância.