Reflection .NET API
Attachmate.Reflection.Emulation.OpenSystems Assembly / Attachmate.Reflection.Emulation.OpenSystems Namespace / IFileTransfer Interface / WRQHostRecordSize Property


In This Topic
    WRQHostRecordSize Property
    In This Topic
    Returns or specifies the record size (in bytes) for files transferred to the host.
    Syntax
    'Declaration
     
    
    Property WRQHostRecordSize As Integer
    'Usage
     
    
    Dim instance As IFileTransfer
    Dim value As Integer
     
    instance.WRQHostRecordSize = value
     
    value = instance.WRQHostRecordSize
    int WRQHostRecordSize {get; set;}

    Property Value

    The default value is 0. The range of values is 0-32767.
    Exceptions
    ExceptionDescription
    Thrown if a value outside the range of valid values is specified.
    Remarks
    The default value—0—specifies that the record size for the host file is to be determined by the host. When you send binary files they are divided up into fixed-length records containing n bytes, where n is the value of WRQHostRecordSize. The last record contains the remainder (assuming the total number of bytes in the file is not evenly divisible by n). When you send an ASCII file, any records containing more than n bytes, where n is the value of WRQHostRecordSize, are split up into smaller records. A host record size specified with an attribute argument to the WRQSendFile method takes precedence over the value of WRQHostRecordSize. A value of 80 is standard for many text editors; 132 is appropriate for many printers. If you don't know what size to use for a particular host program, check other host files used by the same program. This property is relevant only for transfers that use the WRQ/Reflection protocol. The default value is 0. The range of values is 0-32767.
    See Also