LEADTOOLS Image File Support (Leadtools.Codecs assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
WriteTag(Stream,Int32,RasterTagMetadata) Method
See Also 
Leadtools.Codecs Namespace > RasterCodecs Class > WriteTag Method : WriteTag(Stream,Int32,RasterTagMetadata) Method



stream
A System.IO.Stream that contains the file data.
pageNumber
1-based index of the page at which to write the tag.
tag
Tag to identify the data in the TIFF file.
stream
A System.IO.Stream that contains the file data.
pageNumber
1-based index of the page at which to write the tag.
tag
Tag to identify the data in the TIFF file.
Writes or changes a tag to an existing stream.

Syntax

Visual Basic (Declaration) 
Overloads Public Sub WriteTag( _
   ByVal stream As Stream, _
   ByVal pageNumber As Integer, _
   ByVal tag As RasterTagMetadata _
) 
Visual Basic (Usage)Copy Code
Dim instance As RasterCodecs
Dim stream As Stream
Dim pageNumber As Integer
Dim tag As RasterTagMetadata
 
instance.WriteTag(stream, pageNumber, tag)
C# 
public void WriteTag( 
   Stream stream,
   int pageNumber,
   RasterTagMetadata tag
)
C++/CLI 
public:
void WriteTag( 
   Stream^ stream,
   int pageNumber,
   RasterTagMetadata^ tag
) 

Parameters

stream
A System.IO.Stream that contains the file data.
pageNumber
1-based index of the page at which to write the tag.
tag
Tag to identify the data in the TIFF file.

Example

For an example, refer to DeleteTag.

Remarks

This method writes tags into an existing file or changes tags in an existing file.

This method works only with TIFF files.

Note: Use this method carefully. LEADTOOLS will not restrict the tags that you write. If you write bad tags, the file might become corrupted. Consult the TIFF documentation for a list of predefined tags. It is recommended that you write only the user-defined tags (the tags between 0x8000 and 0xFFFF).

See the TIFF documentation for a complete list of the TIFF tags and types.

When you add or remove tags, the tags array at the end of the file is re-written. When you modify existing tags, the new tag value is added to the file and the IFD is modified as necessary. In all of these cases, there is no image recompression.

Some restrictions apply to this function if you use an IFD to indicate to which page to write the tag. See the Loading And Saving Large TIFF Files topic for more information.

Requirements

Target Platforms: Silverlight, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7, MAC OS/X (Intel Only)

See Also