Image

ImageFieldMergingArgs.Image property

Specifica l’immagine che il motore di stampa unione deve inserire nel documento.

public Image Image { get; set; }

Esempi

Mostra come utilizzare un callback per personalizzare la logica di unione delle immagini.

public void MergeFieldImages()
{
    Document doc = new Document();

    // Inserisci un MERGEFIELD che accetterà le immagini da una fonte durante una stampa unione. Utilizzare il codice di campo come riferimento
    // una colonna nell'origine dati che contiene i nomi dei file di sistema locale delle immagini che desideriamo utilizzare nella stampa unione.
    DocumentBuilder builder = new DocumentBuilder(doc);
    FieldMergeField field = (FieldMergeField)builder.InsertField("MERGEFIELD Image:ImageColumn");

    // In questo caso, il campo prevede che l'origine dati abbia una colonna denominata "ImageColumn".
    Assert.AreEqual("Image:ImageColumn", field.FieldName);

    // I nomi dei file possono essere lunghi e se riusciamo a trovare un modo per evitare di memorizzarli nell'origine dati,
    // potremmo ridurne considerevolmente le dimensioni.
    // Crea un'origine dati che fa riferimento alle immagini utilizzando nomi brevi.
    DataTable dataTable = new DataTable("Images");
    dataTable.Columns.Add(new DataColumn("ImageColumn"));
    dataTable.Rows.Add("Dark logo");
    dataTable.Rows.Add("Transparent logo");

    // Assegna un callback di unione che contenga tutta la logica che elabora quei nomi,
     // e quindi eseguire la stampa unione.
    doc.MailMerge.FieldMergingCallback = new ImageFilenameCallback();
    doc.MailMerge.Execute(dataTable);

    doc.Save(ArtifactsDir + "Field.MERGEFIELD.Images.docx");
}

/// <summary>
/// Contiene un dizionario che associa i nomi delle immagini ai nomi dei file del sistema locale che contengono queste immagini.
/// Se un'origine dati di stampa unione utilizza uno dei nomi del dizionario per fare riferimento a un'immagine,
/// questa richiamata passerà il rispettivo nome file alla destinazione dell'unione.
/// </summary>
private class ImageFilenameCallback : IFieldMergingCallback
{
    public ImageFilenameCallback()
    {
        mImageFilenames = new Dictionary<string, string>();
        mImageFilenames.Add("Dark logo", ImageDir + "Logo.jpg");
        mImageFilenames.Add("Transparent logo", ImageDir + "Transparent background logo.png");
    }

    void IFieldMergingCallback.FieldMerging(FieldMergingArgs args)
    {
        throw new NotImplementedException();
    }

    void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
    {
        if (mImageFilenames.ContainsKey(args.FieldValue.ToString()))
        {
            #if NET48 || JAVA
            args.Image = Image.FromFile(mImageFilenames[args.FieldValue.ToString()]);
            #elif NET5_0_OR_GREATER
            args.Image = SKBitmap.Decode(mImageFilenames[args.FieldValue.ToString()]);
            args.ImageFileName = mImageFilenames[args.FieldValue.ToString()];
            #endif
        }

        Assert.NotNull(args.Image);
    }

    private readonly Dictionary<string, string> mImageFilenames;
}

Guarda anche

ImageFieldMergingArgs.ImageFileName