Kentico CMS 7.0 Developer's Guide

GetFile.aspx parameters

GetFile.aspx parameters

Previous topic Next topic Mail us feedback on this topic!  

GetFile.aspx parameters

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

The system uses the GetFile.aspx page to retrieve uploaded files from the database. The page is called whenever you use /getdoc, /getattachment or a direct URL based on the alias path of a cms.file document.

 

GetFile URLs accept the following query string parameters:

 

Parameter name

Description

Sample value

guid

Attachment GUID value.

 

nodeguid

Node GUID value.


versionhistoryid

Version history ID of the attachment. It can only be used together with the guid parameter.


width

Resizes the image to a specified width (in pixels).

100

height

Resizes the image to a specified height (in pixels).

400

maxsidesize

Resizes the image to the specified size of the longest side (in pixels).

500

disposition

Indicates the output disposition of the file.

 

You can use one of the following disposition values:

 

inline - opens the file in the browser window if possible

attachment - opens the browser's "Save or Open" dialog

inline

 

or

 

attachment

 

Resizing of images

 

If your website has the Resize images according to device profile setting enabled in Site Manager -> Settings -> Content -> Content management, the system may override the width, height and maxsidesize parameters used in GetFile URLs of image files. When a user views the website on a device that matches a device profile, images automatically reduce their maximum side size to the larger of the dimensions set for the given profile.

 

To configure the dimensions of device profiles:

 

1.Go to Site Manager -> Development -> Device profiles.

2.Edit (Edit) a profile.

3.Set the Preview width and Preview height properties.

4.Click Save Save.

 

If you wish to disable device profile resizing for an image, add the resizemode=1 parameter to the GetFile URL.