The mgiPostArgument Tag

Tag Behavior

Use the mgiPostArgument tag to display the value of a post argument. Post arguments are created when you submit a form using the POST method.


Tag Syntax

The mgiPostArgument tag has no required parameters and four optional parameters. The tag form is:

<mgiPostArgument name="Name" defaultValue="Text"
mode="Mode" delimiter="Character">

Required Parameters:

  • None.

Optional Parameters:

  • name - The name is the name of the post argument to display.
  • defaultValue - The defaultValue is the text that displays if the post argument is not found or if the post argument is blank. If a default value is not specified, an empty string (blank) is displayed.
  • mode - The mode is the function that the mgiPostArgument performs. In "returnAllNames" mode, the names of all post arguments are displayed. In "returnAllValues" mode, the values of all post arguments are displayed. In "returnAll" mode, the names and values of all post arguments are displayed in the format below. If you include the mode parameter, the name parameter is not required.
      Name1: Value1
      Name2: Value2
      Name3: Value3
      NameX: ValueX
  • delimiter - The delimiter is the character (e.g., "_", tabs, etc.) that is used to separate the names and values in returnAllNames and returnAllValues modes. The delimiter is also used to separate multiple values for the same post argument name. The default delimiter is a comma. In order to use special reserved characters such as tabs and backslashes as delimiters, you must use the appropriate Escaped String format.


Example Usage and Output

<mgiPostArgument name="Email">

In this example, a field named "Email" is included on a form. When a web site visitor completes the form, they enter "info@domain.edu" in the "Email" field and submit the form. The following is displayed in the location of the mgiPostArgument tag:

info@domain.edu


Suggested Usage

  • Form Processing


[Understanding MGI Menu] [Using MGI Menu] [Referencing MGI Menu]


[MGI Guides Main Menu] [User Guide Main Menu]