内存中为TIFF图片添加PropertyItem后保存加载的异常问题

核心问题分析 #

你遇到的问题本质是两个关键点：

1. 直接修改PropertyItems里的原有实例，会覆盖原标签，导致保存时丢失该标签；
2. System.Drawing的Image.Save对TIFF元数据支持有限，尤其是多页TIFF，默认保存时可能会丢弃部分自定义或非标准标签。

另外，自定义ASCII标签需要符合TIFF规范（以\0结尾），否则可能无法被正确识别和保存。

解决方案 #

1. 正确创建/克隆PropertyItem（避免覆盖原有标签） #

绝对不要直接修改从image.PropertyItems取出的实例——这会修改原有标签的内容，导致保存时丢失原标签。正确的做法是创建新的PropertyItem实例，或者深度克隆现有实例后修改。

方法一：使用FormatterServices.GetUninitializedObject创建新实例（你的更新版函数是正确的）

private PropertyItem CreateBasePropertyItem()
{
    return (PropertyItem)FormatterServices.GetUninitializedObject(typeof(PropertyItem));
}

使用时注意补全TIFF规范要求的ASCII终止符：

// 创建新标签实例
PropertyItem property = CreateBasePropertyItem();
property.Id = 38888;
property.Type = 2; // TIFF ASCII类型
string tagContent = "This is a test tag.";
// ASCII标签必须以null结尾，符合TIFF规范
property.Value = Encoding.ASCII.GetBytes(tagContent + "\0");
property.Len = property.Value.Length;

// 添加新标签（不会覆盖原有项）
image.SetPropertyItem(property);

方法二：深度克隆现有PropertyItem（微软推荐方式）

如果需要继承原有标签的部分属性，可以克隆现有实例再修改：

private PropertyItem ClonePropertyItem(PropertyItem original)
{
    PropertyItem newItem = (PropertyItem)FormatterServices.GetUninitializedObject(typeof(PropertyItem));
    newItem.Id = original.Id;
    newItem.Type = original.Type;
    newItem.Len = original.Len;
    // 深拷贝Value数组，避免修改原实例的内容
    newItem.Value = (byte[])original.Value.Clone();
    return newItem;
}

使用示例：

// 克隆任意一个现有标签作为模板
PropertyItem property = ClonePropertyItem(image.PropertyItems[0]);
// 修改为自定义标签属性
property.Id = 38888;
property.Type = 2;
string tagContent = "This is a test tag.";
property.Value = Encoding.ASCII.GetBytes(tagContent + "\0");
property.Len = property.Value.Length;

image.SetPropertyItem(property);

2. 优化TIFF保存逻辑，减少元数据丢失 #

System.Drawing默认保存多页TIFF时，可能不会完整保留所有页的元数据。可以通过ImageCodecInfo和EncoderParameters精确控制保存过程：

using (MemoryStream msOut = new MemoryStream())
{
    using (MemoryStream ms = new MemoryStream(imageCache))
    {
        using (Image image = Image.FromStream(ms))
        {
            image.SelectActiveFrame(FrameDimension.Page, 0);
            // 添加自定义标签（用上面的正确方式）
            PropertyItem property = CreateBasePropertyItem();
            property.Id = 38888;
            property.Type = 2;
            property.Value = Encoding.ASCII.GetBytes("This is a test tag.\0");
            property.Len = property.Value.Length;
            image.SetPropertyItem(property);

            // 获取TIFF编码器
            ImageCodecInfo tiffCodec = ImageCodecInfo.GetImageEncoders()
                .FirstOrDefault(c => c.FormatID == ImageFormat.Tiff.Guid);

            if (tiffCodec != null)
            {
                EncoderParameters encoderParams = new EncoderParameters(1);
                // 以多帧模式保存第一页
                encoderParams.Param[0] = new EncoderParameter(Encoder.SaveFlag, (long)EncoderValue.MultiFrame);
                image.Save(msOut, tiffCodec, encoderParams);

                // 依次保存剩余页
                for (int i = 1; i < image.GetFrameCount(FrameDimension.Page); i++)
                {
                    image.SelectActiveFrame(FrameDimension.Page, i);
                    encoderParams.Param[0] = new EncoderParameter(Encoder.SaveFlag, (long)EncoderValue.FrameDimensionPage);
                    image.SaveAdd(msOut, encoderParams);
                }

                // 完成保存
                encoderParams.Param[0] = new EncoderParameter(Encoder.SaveFlag, (long)EncoderValue.Flush);
                image.SaveAdd(encoderParams);
            }
            else
            {
                // fallback到默认保存
                image.Save(msOut, image.RawFormat);
            }
        }
    }
    imageCache = msOut.ToArray();
}

3. 终极方案：使用专门的TIFF处理库 #

如果System.Drawing的局限性无法满足需求，推荐使用LibTiff.Net（开源免费），它对TIFF元数据的支持更完善，能精确控制每一页的标签，不会丢失原有属性。

示例代码（核心逻辑）：

using (Tiff inputTiff = Tiff.Open(@"c:\test\test.tif", "r"))
using (Tiff outputTiff = Tiff.Open(@"c:\test\output.tif", "w"))
{
    int pageCount = inputTiff.NumberOfDirectories();
    for (int i = 0; i < pageCount; i++)
    {
        inputTiff.SetDirectory(i);
        // 复制当前页的所有原有标签
        TiffTag tag = TiffTag.FirstTag;
        while ((tag = inputTiff.NextTag(tag)) != TiffTag.NullTag)
        {
            outputTiff.SetField(tag, inputTiff.GetField(tag));
        }

        // 添加自定义标签（ID38888，ASCII类型）
        outputTiff.SetField((TiffTag)38888, "This is a test tag.");

        // 复制图像数据
        int width = inputTiff.GetField(TiffTag.IMAGEWIDTH)[0].ToInt32();
        int height = inputTiff.GetField(TiffTag.IMAGELENGTH)[0].ToInt32();
        byte[] buffer = new byte[width * inputTiff.SamplesPerPixel() * inputTiff.BitsPerSample() / 8];
        for (int row = 0; row < height; row++)
        {
            inputTiff.ReadScanline(buffer, row);
            outputTiff.WriteScanline(buffer, row);
        }

        outputTiff.WriteDirectory();
    }
}

总结 #

• 不要直接修改PropertyItems中的原有实例，必须创建新的PropertyItem实例；
• ASCII类型的自定义标签要以\0结尾，符合TIFF规范；
• 多页TIFF保存时用ImageCodecInfo+EncoderParameters控制流程，减少元数据丢失；
• 若System.Drawing无法满足需求，改用LibTiff.Net这类专业TIFF库。

内容的提问来源于stack exchange，提问作者Arvo Bowen