ImageGear v26.3 - Updated
ImageGear.Core Assembly / ImageGear.Formats Namespace / ImGearFileFormats Class / UpdateDocumentMetadata Method
Data stream containing a source image.
Data stream to write the updated image to.
Document metadata tree to be saved to the new image.




In This Topic
    UpdateDocumentMetadata Method
    In This Topic
    Updates document metadata without changing pixel data.
    Syntax
    'Declaration
     
    Public Shared Sub UpdateDocumentMetadata( _
       ByVal sourceStream As Stream, _
       ByVal destinationStream As Stream, _
       ByVal metadata As ImGearMetadataHead _
    ) 
    'Usage
     
    Dim sourceStream As Stream
    Dim destinationStream As Stream
    Dim metadata As ImGearMetadataHead
     
    ImGearFileFormats.UpdateDocumentMetadata(sourceStream, destinationStream, metadata)
    public static void UpdateDocumentMetadata( 
       Stream sourceStream,
       Stream destinationStream,
       ImGearMetadataHead metadata
    )
    public: static void UpdateDocumentMetadata( 
       Stream* sourceStream,
       Stream* destinationStream,
       ImGearMetadataHead* metadata
    ) 
    public:
    static void UpdateDocumentMetadata( 
       Stream^ sourceStream,
       Stream^ destinationStream,
       ImGearMetadataHead^ metadata
    ) 

    Parameters

    sourceStream
    Data stream containing a source image.
    destinationStream
    Data stream to write the updated image to.
    metadata
    Document metadata tree to be saved to the new image.
    Exceptions
    ExceptionDescription
    Thrown if the specified stream is null or metadata parameter is null.

    Thrown with ImGearErrorCodes.PAGE_NOT_PRESENT error code if the source stream represents DICOM vector waveform data.

    Thrown with ImGearErrorCodes.CANT_SAVE_FORMAT error code if the metadata cannot be updated due to invalid data in the source stream.

    Remarks

    This method replaces the metadata associated with a document loaded from the source image with the provided metadata and saves the updated image to the destination stream. This method does not replace the metadata assotiated with individual pages. This method does not change the actual pixel data. The structure of the provided metadata tree should correspond to the metadata tree from the source image. This method does not save any metadata tags provided in the metadata tree that are not supported by the source image format. See ImageGear.Core.ImGearMetadataNode for more details about the ImageGear metadata.

    This method is only supported for PDF, PS and DICOM file formats.

    See Also