Method Description

Binary.fname()

Access the filename stored against a binary object.

Syntax

String = Binary.fname(filename)

Parameters

The 'Binary.fname' method takes 1 parameter:

Results

The 'Binary.fname' method returns String:

Remarks

This method returns the filename stored against the binary object. If the binary object is from a browser (via rb.page.formdata) then the initial value will be the filename provided by the browser with the file being posted. This is generally the fully qualified pathname on the client machine.

If the binary object has been created by a Presentation Page then the default value for the filename is an empty string.

If the optional file name parameter is specified in the call then this value is stored with the binary object. In this case the string returned in the call is the new value of the string (i.e. the filename is modified first then the return value generated].

If you want to use the Binary.load() method then the name is relative to the root of the clients virtual server.