ImageGear .NET - Updated
UpdatePageMetadata(Stream,Stream,ImGearMetadataHead,ImGearLoadOptions) Method




ImageGear24.Core Assembly > ImageGear.Formats Namespace > ImGearFileFormats Class > UpdatePageMetadata Method : UpdatePageMetadata(Stream,Stream,ImGearMetadataHead,ImGearLoadOptions) Method
The data stream, containing source image.
The data stream to which to write result image.
Metadata to be saved to result file.
The loading options.
This method has been deprecated. Creates a new file with exact copy of source file's pixel data and with new metadata.
Syntax
'Declaration
 
<ObsoleteAttribute("This method will be removed from the public API in a future release. Use UpdateDocumentMetadata to update DICOM metadata.")>
Public Overloads Shared Sub UpdatePageMetadata( _
   ByVal sourceStream As Stream, _
   ByVal destinationStream As Stream, _
   ByVal metadata As ImGearMetadataHead, _
   ByVal options As ImGearLoadOptions _
) 
'Usage
 
Dim sourceStream As Stream
Dim destinationStream As Stream
Dim metadata As ImGearMetadataHead
Dim options As ImGearLoadOptions
 
ImGearFileFormats.UpdatePageMetadata(sourceStream, destinationStream, metadata, options)
[Obsolete("This method will be removed from the public API in a future release. Use UpdateDocumentMetadata to update DICOM metadata.")]
public static void UpdatePageMetadata( 
   Stream sourceStream,
   Stream destinationStream,
   ImGearMetadataHead metadata,
   ImGearLoadOptions options
)
[Obsolete("This method will be removed from the public API in a future release. Use UpdateDocumentMetadata to update DICOM metadata.")]
public: static void UpdatePageMetadata( 
   Stream* sourceStream,
   Stream* destinationStream,
   ImGearMetadataHead* metadata,
   ImGearLoadOptions* options
) 
[Obsolete("This method will be removed from the public API in a future release. Use UpdateDocumentMetadata to update DICOM metadata.")]
public:
static void UpdatePageMetadata( 
   Stream^ sourceStream,
   Stream^ destinationStream,
   ImGearMetadataHead^ metadata,
   ImGearLoadOptions^ options
) 

Parameters

sourceStream
The data stream, containing source image.
destinationStream
The data stream to which to write result image.
metadata
Metadata to be saved to result file.
options
The loading options.
Remarks
This method creates a new file with an exact copy of the source file's pixel data and with new metadata. Pixel data is not decoded but copied directly from source to destination file.

This method can be used for updating metadata in an image file without modifying the pixel data. To achieve this, delete the source file after calling this method, and rename result file to the source file name.

Tags that affect decoding of pixel data are transferred from the source file, and not replaced with tags from metadata.

Currently, the method only supports metadata updating in the DICOM file format.

See Also

Reference

ImGearFileFormats Class
ImGearFileFormats Members
Overload List
ImGearMetadataHead Class
ImGearLoadOptions Class