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:
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
|