URL (HttpRequest property): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (match syntax table to syntax template, tags and edits)
mNo edit summary
 
Line 3: Line 3:
<var>[[Host (HttpRequest property)|Host]]</var>, <var>[[Port (HttpRequest property)|Port]]</var>, and <var>[[Page (HttpRequest property)|Page]]</var> properties.
<var>[[Host (HttpRequest property)|Host]]</var>, <var>[[Port (HttpRequest property)|Port]]</var>, and <var>[[Page (HttpRequest property)|Page]]</var> properties.


You set the URL for an HTTP request by assigning a value to <var>Url</var>, and you fetch its value by referencing it without any parameters.
You set the URL for an HTTP request by assigning a value to <var>URL</var>, and you fetch its value by referencing it without any parameters.


==Syntax==
==Syntax==
Line 9: Line 9:
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>currentString</th>
<tr><th>%currentString</th>
<td>A string or <var>[[Longstrings|Longstring]]</var> variable for the assignment of the current value of Url.</td></tr>
<td>A string or <var>[[Longstrings|Longstring]]</var> variable for the assignment of the current value of <var>URL</var>.</td></tr>
<tr><th>httpRequest</th>
<tr><th>httpRequest</th>
<td>A previously defined and instantiated <var>HttpRequest</var> object.</td></tr>
<td>A previously defined and instantiated <var>HttpRequest</var> object.</td></tr>
<tr><th>newString</th>
<tr><th>newString</th>
<td>A string expression that contains a complete URL, potentially including protocol, host, port, and page. The value is parsed and validated, and its parts are then available to the individual property calls (<var>Protocol</var>, <var>Host</var>, <var>Port</var>, <var>Page</var>). If <var class="term">newString</var> cannot be parsed, the request is cancelled.
<td>A string expression that contains a complete URL, potentially including protocol, host, port, and page. The value is parsed and validated, and its parts are then available to the individual property calls (<var>Protocol</var>, <var>Host</var>, <var>Port</var>, <var>Page</var>). If <var class="term">newString</var> cannot be parsed, the request is cancelled.
<p>The default value is the concatenation of the defaults of the properties that return the individual parts of the URL; and is the URL of a web server running on the same machine as the client:</p>
<p>The default value is the concatenation of the defaults of the properties that return the individual parts of the URL, that is, the URL of a web server running on the same machine as the client:</p>
<p class="code"> http://127.0.0.1:80/</p>
<p class="code"> http://127.0.0.1:80/</p>
Port defaults to <code>80</code>; Protocol defaults to <code>http://</code>; Host defaults to <code>127.0.0.1</code>; and Page defaults to <code>/</code> (the root page from the domain).
<var>Port</var> defaults to <code>80</code>; <var>Protocol</var> defaults to <code>http://</code>; <var>Host</var> defaults to <code>127.0.0.1</code>; and <var>Page</var> defaults to <code>/</code> (the root page from the domain).
</td></tr>
</td></tr>
</table>
</table>
Line 23: Line 23:
==Usage notes==
==Usage notes==
<ul>
<ul>
<li>Referencing <var>Url</var> returns the entire URL, whether it was set in one call using <var>Url</var>, or set in parts using the <var>Protocol</var>, <var>Host</var>, <var>Port</var>, and <var>Page</var> properties.
<li>Referencing <var>URL</var> returns the entire URL, whether it was set in one call using <var>URL</var>, or set in parts using the <var>Protocol</var>, <var>Host</var>, <var>Port</var>, and <var>Page</var> properties.
</ul>
</ul>


==See also==
==See also==
{{Template:HttpRequest:URL footer}}
{{Template:HttpRequest:URL footer}}

Latest revision as of 21:59, 21 June 2011

Target HTTP request URL (HttpRequest class)

The URL method lets you set or examine the whole URL with one method call, instead of setting/getting parts of the URL with the Protocol, Host, Port, and Page properties.

You set the URL for an HTTP request by assigning a value to URL, and you fetch its value by referencing it without any parameters.

Syntax

%currentString = httpRequest:URL httpRequest:URL = newString

Syntax terms

%currentString A string or Longstring variable for the assignment of the current value of URL.
httpRequest A previously defined and instantiated HttpRequest object.
newString A string expression that contains a complete URL, potentially including protocol, host, port, and page. The value is parsed and validated, and its parts are then available to the individual property calls (Protocol, Host, Port, Page). If newString cannot be parsed, the request is cancelled.

The default value is the concatenation of the defaults of the properties that return the individual parts of the URL, that is, the URL of a web server running on the same machine as the client:

http://127.0.0.1:80/

Port defaults to 80; Protocol defaults to http://; Host defaults to 127.0.0.1; and Page defaults to / (the root page from the domain).

Usage notes

  • Referencing URL returns the entire URL, whether it was set in one call using URL, or set in parts using the Protocol, Host, Port, and Page properties.

See also