Reference Guide
GdPicture14.WPF Namespace / GdViewer Class / TagGetValueString Method
The sequence index of the required tag within the displayed document. It must be a value from 1 to TagCount.
Example





In This Topic
    TagGetValueString Method (GdViewer)
    In This Topic
    Returns a string representation of the current tag value of the required tag, that is embedded within the document displayed in the GdViewer control.
    Syntax
    'Declaration
     
    
    Public Function TagGetValueString( _
       ByVal TagNo As Integer _
    ) As String
    public string TagGetValueString( 
       int TagNo
    )
    public function TagGetValueString( 
        TagNo: Integer
    ): String; 
    public function TagGetValueString( 
       TagNo : int
    ) : String;
    public: string* TagGetValueString( 
       int TagNo
    ) 
    public:
    String^ TagGetValueString( 
       int TagNo
    ) 

    Parameters

    TagNo
    The sequence index of the required tag within the displayed document. It must be a value from 1 to TagCount.

    Return Value

    The current tag value as a string. Please always use the GetStat method to determine if this method has been successful.
    Remarks
    It is recommend to use the GetStat method to identify the specific reason for the method's failure, if any.

    Please note that this method handles EXIF tags, IPTC tags, Extra tags (like Adobe Image Information tags etc.), Thumbnail related tags, GPS tags and XML packet metadata.

    Example
    How to find out the tag's value.
    'We assume that the GdViewer1 control has been properly integrated
    'and your document has been properly displayed as well.
    Dim count As Integer = GdViewer1.TagCount()
    If GdViewer1.GetStat() = GdPictureStatus.OK Then
        Dim message As String = "Tags count: " + count + vbCrLf
        Dim tagID As Tags = Tags.TagUnknown
        Dim tagName As String = "", tagValue As String = ""
        For i As Integer = 1 To count
            tagID = GdViewer1.TagGetID(i)
            If GdViewer1.GetStat() = GdPictureStatus.OK Then tagName = GdViewer1.TagGetName(i)
            If GdViewer1.GetStat() = GdPictureStatus.OK Then tagValue = GdViewer1.TagGetValueString(i)
                
            If GdViewer1.GetStat() = GdPictureStatus.OK Then
                message = message + vbCrLf + tagName + " (" + tagID + "): " + tagValue
            Else
                message = message + vbCrLf + "Tag nr." + i + "  Status: " + GdViewer1.GetStat().ToString()
            End If
        Next
        MessageBox.Show(message, "GdViewer.TagGetValueString")
    Else
        MessageBox.Show("The number of tags can't be found. Status: " + GdViewer1.GetStat().ToString(), "GdViewer.TagGetValueString")
    End If
    //We assume that the GdViewer1 control has been properly integrated.
    //and your document has been properly displayed as well.
    int count = GdViewer1.TagCount();
    if (GdViewer1.GetStat() == GdPictureStatus.OK)
    {
        string message = "Tags count: " + count + "\n";
        Tags tagID = Tags.TagUnknown;
        string tagName = "", tagValue = "";
        for (int i = 1; i <= count; i++)
        {
            tagID = GdViewer1.TagGetID(i);
            if (GdViewer1.GetStat() == GdPictureStatus.OK)
                tagName = GdViewer1.TagGetName(i);
            if (GdViewer1.GetStat() == GdPictureStatus.OK)
                tagValue = GdViewer1.TagGetValueString(i);
            if (GdViewer1.GetStat() == GdPictureStatus.OK)
                message = message + "\n" + tagName + " (" + tagID + "): " + tagValue;
            else
                message = message + "\nTag nr." + i + "  Status: " + GdViewer1.GetStat().ToString();
        }
        MessageBox.Show(message, "GdViewer.TagGetValueString");
    }
    else
        MessageBox.Show("The number of tags can't be found. Status: " + GdViewer1.GetStat().ToString(), "GdViewer.TagGetValueString");
    See Also