PDF (adobe.com)

Insert ColdFusion file fields

You can visually insert a ColdFusion file field into your form and set its properties. Use a file field to let users select a file from their computer, such as a word processing document or a graphics file, and upload it to the server. A ColdFusion file field looks like other text fields, except it also has a Browse button. Users can manually enter the path to the file they want to upload, or use the Browse button to locate and select the file.

File fields require that you use the POST method to transmit files from the browser to the server. The file is posted to the address that you specify in the form’s Action box. Contact your server administrator to confirm that anonymous file uploads are allowed before using a file field in your form.

File fields also require that the form encoding be set to multipart/form. Dreamweaver sets this automatically when you insert a file field control.

Note: This enhancement is available only if you have access to a computer running ColdFusion MX 7 or later.
  1. In Design view, select the CFForm to display its Property inspector.

    To quickly select the form, click anywhere in the form outline and click the <cfform> tag in the tag selector at the bottom of the Document window.

  2. In the Property inspector, set the form method to POST.
  3. From the Enctype pop‑up menu, select multipart/form-data.
  4. Position the insertion point inside the form outline where you want to file field to appear.
  5. Select Insert > ColdFusion Objects > CFForm > CFfilefield.

    A file field appears in the document.

  6. Select the file field on the page and set any of the following properties in the Property inspector:
    Cffilefield
    Lets you specify a unique name for the control.

    Max Length
    Lets you specify the maximum number of characters that the path to the file can have.

    Validate
    Specifies the type of validation for the field.

    Validate At
    Specifies when the field is validated: onSubmit, onBlur, or onServer.

    Label
    Lets you specify a label for the field.

    Pattern
    Lets you specify a JavaScript regular expression pattern to validate input. Omit leading and trailing slashes. For more information, see the ColdFusion documentation.

    Height
    Lets you specify the height of the control, in pixels. This property is ignored by the ColdFusion server at run time.

    Width
    Lets you specify the width of the control, in pixels. This property is ignored by the ColdFusion server at run time.

    Size
    Lets you specify the size of the control.

    Required
    Lets you specify whether the file field must contain data before the form is submitted to the server.

    Display Tag Editor
    Lets you edit properties not listed in the Property inspector.