SetImage

SetImage(Image)

Establece la imagen que muestra la forma.

public void SetImage(Image image)
ParámetroEscribeDescripción
imageImageEl objeto de la imagen.

Ejemplos

Muestra cómo mostrar imágenes del sistema de archivos local en un documento.

Document doc = new Document();

// Para mostrar una imagen en un documento, necesitaremos crear una forma
// que contendrá una imagen y luego la agregará al cuerpo del documento.
Shape imgShape;

// A continuación se muestran dos formas de obtener una imagen de un archivo en el sistema de archivos local.
// 1 - Crea un objeto de imagen a partir de un archivo de imagen:
using (Image srcImage = Image.FromFile(ImageDir + "Logo.jpg"))
{
    imgShape = new Shape(doc, ShapeType.Image);
    doc.FirstSection.Body.FirstParagraph.AppendChild(imgShape);
    imgShape.ImageData.SetImage(srcImage);
}

// 2 - Abre un archivo de imagen desde el sistema de archivos local usando una secuencia:
using (Stream stream = new FileStream(ImageDir + "Logo.jpg", FileMode.Open, FileAccess.Read))
{
    imgShape = new Shape(doc, ShapeType.Image);
    doc.FirstSection.Body.FirstParagraph.AppendChild(imgShape);
    imgShape.ImageData.SetImage(stream);
    imgShape.Left = 150.0f;
}

doc.Save(ArtifactsDir + "Drawing.ImportImage.docx");

Ver también

SetImage(Stream)

Establece la imagen que muestra la forma.

public void SetImage(Stream stream)
ParámetroEscribeDescripción
streamStreamLa secuencia que contiene la imagen.

Ejemplos

Muestra cómo mostrar imágenes del sistema de archivos local en un documento.

Document doc = new Document();

// Para mostrar una imagen en un documento, necesitaremos crear una forma
// que contendrá una imagen y luego la agregará al cuerpo del documento.
Shape imgShape;

// A continuación se muestran dos formas de obtener una imagen de un archivo en el sistema de archivos local.
// 1 - Crea un objeto de imagen a partir de un archivo de imagen:
using (Image srcImage = Image.FromFile(ImageDir + "Logo.jpg"))
{
    imgShape = new Shape(doc, ShapeType.Image);
    doc.FirstSection.Body.FirstParagraph.AppendChild(imgShape);
    imgShape.ImageData.SetImage(srcImage);
}

// 2 - Abre un archivo de imagen desde el sistema de archivos local usando una secuencia:
using (Stream stream = new FileStream(ImageDir + "Logo.jpg", FileMode.Open, FileAccess.Read))
{
    imgShape = new Shape(doc, ShapeType.Image);
    doc.FirstSection.Body.FirstParagraph.AppendChild(imgShape);
    imgShape.ImageData.SetImage(stream);
    imgShape.Left = 150.0f;
}

doc.Save(ArtifactsDir + "Drawing.ImportImage.docx");

Ver también

SetImage(string)

Establece la imagen que muestra la forma.

public void SetImage(string fileName)
ParámetroEscribeDescripción
fileNameStringEl archivo de imagen. Puede ser un nombre de archivo o una URL.

Ejemplos

Muestra cómo insertar una imagen vinculada en un documento.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

string imageFileName = ImageDir + "Windows MetaFile.wmf";

// A continuación se muestran dos formas de aplicar una imagen a una forma para que pueda mostrarla.
// 1 - Establece la forma para contener la imagen.
Shape shape = new Shape(builder.Document, ShapeType.Image);
shape.WrapType = WrapType.Inline;
shape.ImageData.SetImage(imageFileName);

builder.InsertNode(shape);

doc.Save(ArtifactsDir + "Image.CreateLinkedImage.Embedded.docx");

// Cada imagen que almacenemos en forma aumentará el tamaño de nuestro documento.
Assert.True(70000 < new FileInfo(ArtifactsDir + "Image.CreateLinkedImage.Embedded.docx").Length);

doc.FirstSection.Body.FirstParagraph.RemoveAllChildren();

// 2 - Establece la forma para vincular a un archivo de imagen en el sistema de archivos local.
shape = new Shape(builder.Document, ShapeType.Image);
shape.WrapType = WrapType.Inline;
shape.ImageData.SourceFullName = imageFileName;

builder.InsertNode(shape);
doc.Save(ArtifactsDir + "Image.CreateLinkedImage.Linked.docx");

// Vincular a imágenes ahorrará espacio y dará como resultado un documento más pequeño.
// Sin embargo, el documento sólo puede mostrar la imagen correctamente mientras
// el archivo de imagen está presente en la ubicación a la que apunta la propiedad "SourceFullName" de la forma.
Assert.True(10000 > new FileInfo(ArtifactsDir + "Image.CreateLinkedImage.Linked.docx").Length);

Ver también

ImageData.Save ImageData.ToByteArray