Reflection
TransmitFile Method


The name of the file to transmit. Supply complete path information if the file isn't on the Reflection macro path.
Specifies the amount of time to pause between each line of the file, in HH:MM:SS.hh format. If this argument is empty (""), Reflection does not pause between lines (though it may wait for PromptChar if one is specified).
Specifies a character Reflection is to wait for between lines of the file.
Specifies additional, non-default behavior for the method. There are two options for this method: TransmitFileOption.NoTranslation Indicates that the file contains binary data, and should not be translated from the PC character set into the host character set. Use this option if the file contains characters that are already in the host character set. TransmitFileOption.NoDisplay Specifies that incoming characters should not be displayed in the terminal window while waiting for the PromptChar or for PauseTime at the end of a line. If both of the PauseTime and PromptChar arguments are not specified, this option has no effect (the method does not read incoming data from the host). To combine the two options, use the addition operator: TransmitFileOption.NoTranslation + TransmitFileOption.NoDisplay.
Transmits the specified file to the host. If the ReadTabAsSpaces property is True and the TransmitFilesOption.NoTranslation option is not specified, tab characters in the file are converted to spaces as they are transmitted to the host. If the ReadCtrlZAsEOF property is True and the TransmitFilesOption.NoTranslation option is not specified, a Ctrl+Z character in the file will terminate the method.
Syntax
'Declaration
 
Function TransmitFile( _
   ByVal fileName As String, _
   ByVal pause As String, _
   ByVal promptChar As String, _
   ByVal option As TransmitFileOption _
) As ReturnCode
'Usage
 
Dim instance As IFileTransfer
Dim fileName As String
Dim pause As String
Dim promptChar As String
Dim option As TransmitFileOption
Dim value As ReturnCode
 
value = instance.TransmitFile(fileName, pause, promptChar, option)

Parameters

fileName
The name of the file to transmit. Supply complete path information if the file isn't on the Reflection macro path.
pause
Specifies the amount of time to pause between each line of the file, in HH:MM:SS.hh format. If this argument is empty (""), Reflection does not pause between lines (though it may wait for PromptChar if one is specified).
promptChar
Specifies a character Reflection is to wait for between lines of the file.
option
Specifies additional, non-default behavior for the method. There are two options for this method: TransmitFileOption.NoTranslation Indicates that the file contains binary data, and should not be translated from the PC character set into the host character set. Use this option if the file contains characters that are already in the host character set. TransmitFileOption.NoDisplay Specifies that incoming characters should not be displayed in the terminal window while waiting for the PromptChar or for PauseTime at the end of a line. If both of the PauseTime and PromptChar arguments are not specified, this option has no effect (the method does not read incoming data from the host). To combine the two options, use the addition operator: TransmitFileOption.NoTranslation + TransmitFileOption.NoDisplay.
See Also