LineEnd (HttpRequest property): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
Line 11: Line 11:
<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>newLineEnd</th>
<tr><th>newLineEnd</th>
<td>Identifies the new line-end sequence to use for the <var>Stringlist</var> items being copied into the Post data. Each copied <var>Stringlist</var> item has a line-end sequence appended to it. The options you may specify are these <var>LineEnd</var> <var>Enumeration</var> values:
<td>Identifies the new line-end sequence to use for the <var>Stringlist</var> items being copied into the Post data. Each copied <var>Stringlist</var> item has a line-end sequence appended to it. The options you may specify are these <var>LineEnd</var> <var>Enumeration</var> (see below) values: <var>CRLF</var>, <var>CR</var>, and <var>LF</var>.
<dl><dt>CRLF <dd>Use carriage-return/line-feed (hex value X'0D0A'). This is the default for a newly created <var>HttpRequest</var> object.
<dt>CR <dd>Use only carriage-return (X'0D').
<dt>LF <dd>Use only line-feed (X'0A').
</dl>
</td></tr></table>
</td></tr></table>
<h3>LineEnd enumeration</h3>
The values of this enumeration are the following:
<table class="syntaxNested">
<tr><th>CRLF </th>
<td>Use carriage-return/line-feed (hex value X'0D0A'). This is the default for a newly created <var>HttpRequest</var> object. </td></tr>
<tr><th>CR </th>
<td>Use only carriage-return (X'0D'). </td></tr>
<tr><th>LF </th>
<td>Use only line-feed (X'0A'). </td></tr>
</table>


==Usage notes==
==Usage notes==

Revision as of 20:21, 24 June 2011

Line-end sequence for POSTed Stringlist data (HttpRequest class)

The LineEnd settable property lets you select which of three line-end sequences to use when you add a file to form Post data by passing a Stringlist object to the AddField method.

Syntax

%currentLineEnd = httpRequest:LineEnd httpRequest:LineEnd = newLineEnd

Syntax terms

%currentLineEnd The string variable that will be assignment the current value of LineEnd.
httpRequest A previously defined and instantiated HttpRequest object.
newLineEnd Identifies the new line-end sequence to use for the Stringlist items being copied into the Post data. Each copied Stringlist item has a line-end sequence appended to it. The options you may specify are these LineEnd Enumeration (see below) values: CRLF, CR, and LF.

LineEnd enumeration

The values of this enumeration are the following:

CRLF Use carriage-return/line-feed (hex value X'0D0A'). This is the default for a newly created HttpRequest object.
CR Use only carriage-return (X'0D').
LF Use only line-feed (X'0A').

Usage notes

  • The LineEnd property must be set before the AddField call that adds the form data.
  • The LineEnd setting remains in effect unless the property is reset with another assignment.
  • For an example of code that uses the LineEnd property, see this AddField example.

Example

The LineEnd format is shown in the following fragment:

%HttpRequest:LineEnd = CRLF %HttpRequest:LineEnd = CR %HttpRequest:LineEnd = LF %HttpRequest:AddField( ....

See also

  • For more general information and background about using Enumerations, see "Enumerations".