NetCode Component [IP*Works! V8]
Properties
Methods
Events
Configuration Settings
The NetCode component can be used to encode or decode files or strings. UUEncode , MIME's Base64 Quoted-Printable , URL encoding formats, as well as secure hash functions such
as MD5 and SHA1, are currently supported.
NOTE: What follows is a very short description of the component interfaces.
For more information, please consult the help files that come with the respective package.
Remarks
The encoding format
is specified by the Format property. The binary data, or the name of the
file containing binary data, is specified by the DecodedData property and
the encoded data or filename is specified by the EncodedData property. The
FileName property may be used to override the default file names or to
specify a directory during uuencoding. After uudecoding, the FileName
property contains the fully specified file name of the decoded file.
Understanding Encoding/Decoding
Most of mail systems use only 7 bits to transmit messages. A binary file such as an
archive or a non-plain text formatted file produced from a text processor should
be first encoded in 7 bit code before email transfer.
Decoding is the inverse process: creation of the original file from the encoded data.
Encoded data is often split over several files because of the size limit placed on
the email message. Each message is preceded by information about this splitting, as well as the
mail header. NetCode supports this case in both directions:
- During encoding setting the MaxFileSize config setting to the maximum size of a message
body instructs NetCode to split the encoded data over several files. Multiple filenames
can be specified by using question marks "?" (See the EncodedData property for more information).
- During decoding, the body messages can be saved in separate files named namexxx.ext
where xxx is a numeral starting at 000 and ext is ".uue", ".b16", or ".q_p" according to
Format. These multiple filenames should be given to EncodedData. While uudecoding,
if the IntelliCode configuration is set to True, NetCode tries to filter the data that
doesn't belong to the pure uuencoded data (This may include mail headers).
Property List
The following is the full list of the properties of the component with short
descriptions. Click on the links for further details.
| |
| DecodedData | The decoded data. |
| DecodedFile | The filename of the decoded data. |
| EncodedData | The encoded data. |
| EncodedFile | Filename of the encoded data. |
| FileCnt | Shows the number of encoded files the component has read from or written into. |
| FileName | The destination filename for the encoded data. |
| Format | The type of encoding to be used. |
| Mode | The UNIX-style filemode when uuencoding / uudecoding. |
| Overwrite | Controls whether created file(s) should overwrite already existing file(s). |
| ProgressStep | Controls the granularity at which the Progress event is fired. Values 0-100. |
Method List
The following is the full list of the methods of the component with short
descriptions. Click on the links for further details.
| |
| Config | Sets or retrieves a configuration setting. |
| Decode | Decode string. |
| Encode | Encode the data. |
| ResetData | Resets the values of all data and stream properties. |
Event List
The following is the full list of the events fired by the component with short
descriptions. Click on the links for further details.
| |
| Error | Information about errors during data delivery. |
| Progress | Occurs when PercentDone of the input is read. |
Configuration Settings
The following is a list of configuration settings for the component with short
descriptions. Click on the links for further details.
| |
| HMACAlgorithm | The hash algorithm to use when generating a Hash-based Message Authentication Code (HMAC). |
| HMACKey | A key to use when generating a Hash-based Message Authentication Code (HMAC). |
| MaxFileSize | When encoding, controls whether encoded data should be split into several files and gives the maximum allowed size for these files. |
| CodePage | The system code page used for Unicode to Multibyte translations. |