본문 바로가기

프로그램&DB/ASP

[ASP] DEXT.FileUpload API (FileUpload, FileDownload, FileUploadMonitor, ImageProc)

 FileUpload 객체

실제로 파일을 업로드하고 서버에 저장하는 기능을 담당하는 컴포넌트의 가장 핵심이 되는 객체입니다.

프로퍼티

이 름

설 명

AutoMakeFolder

이것을 TRUE로 설정하면 DefaultPath, SaveAs 등에 지정한 폴더가 존재하지 않을 경우 폴더를 자동으로 생성한다.

CheckMaxFileLen

MaxFileLen 에 설정한 최대 파일 크기에 대한 초과여부

CodePage 

업로드 컴포넌트 내부적으로 데이터를 처리할 때 사용할 CodePage 를 지정한다.

DefaultPath

임시파일 및 업로드 된 파일을 저장할 디폴트 경로 값을 지정 하는데 사용한다.

FileLen

업로드 된 파일의 길이 값을 가진다.(단일 파일)

FileName

업로드 된 파일의 이름(경로 제외) 값을 가진다.

FileNameWithoutExt

업로드 된 파일의 이름(확장자 제외) 값을 가진다.

FileExtension

업로드 된 파일의 확장자 값을 가진다.

FilePath

업로드 된 파일의 전체 경로 값을 가진다.

Form

Submit Form의 각 항목정보를 저장하고 있는 FormItems Collection 개체

ImageFormat 

업로드 된 이미지 파일(BMP,EMF,EXIF,GIF,Icon,JPEG,PNG,TIFF,WMF)의 포맷을 리턴 한다.

ImageWidth 

업로드 된 이미지 파일의 폭을 리턴 한다. 이미지 파일이 아닌 경우는 -1을 리턴 한다.

ImageHeight 

업로드 된 이미지 파일의 높이를 리턴 한다. 이미지 파일이 아닌 경우는 -1을 리턴 한다.

LastSavedFileName 

업로드 되어 서버에 저장된 파일의 이름(경로 제외) 값을 가진다.

LastSavedFilePath

업로드 되어 서버에 저장된 파일의 전체 경로 값을 가진다.

MaxFileLen

업로드 가능 한 최대 파일 크기를 제한 하는데 사용한다. (단위: Byte) 지정 된 크기보다 큰 파일을 업로드 할 경우 에러가 발생한다. 기본값은 '무제한' 이다.

MimeType

업로드 된 파일의 MimeType 값을 가진다.

TotalLen

업로드 된 파일의 총 길이 값을 가진다. (:다중 파일 업로드 시)

TempFilePath

Save, SaveAs 등으로 파일이 저장되기 이전에 존재하는 임시 파일의 위치이다. DEXT.ImageProc 객체에서 유용하게 사용 할 수 있다.

UploadTimeout

업로드 Timeout값을 지정하는데 사용 한다. (단위: ) 기본값은 3600(60)이다.

IsInfected

바이러스 감염 여부 (DEXTUploadV Professional 제품만 해당)

VirusName

바이러스 이름 (DEXTUploadV Professional 제품만 해당)

ResumeFileName

업로드 중이거나 업로드 될 대용량 파일의 이름을 리턴한다. (DEXTUpload Pro Extension 제품에 해당)

ResumeDirPath

업로드 중이거나 업로드 될 대용량 파일의 임시 저장 위치를 리턴한다. (DEXTUpload Pro Extension 제품에 해당)

ResumeFilePath

업로드 될 대용량 파일의 원본 저장 위치를 리턴한다. (DEXTUpload Pro Extension 제품에 해당)

ResumeFileSize

업로드 중이거나 업로드 될 대용량 파일의 전체 사이즈를 리턴한다. (DEXTUpload Pro Extension 제품에 해당)

ResumeMode

DEXTUpload Pro Extension의 현재 상태를 리턴한다. (DEXTUpload Pro Extension 제품에 해당)


메소드

이 름

설 명

DeleteAllSavedFiles

업로드를 통해 서버에 저장한 모든 파일을 삭제한다.

DeleteFile 

서버에 존재하는 파일을 삭제한다.

FileExists 

특정 파일의 존재 여부를 체크한다.

Flush 

서버에 어떠한 파일도(임시파일 포함) 저장하지 않으면서 웹 브라우저가 보내오는 모든 데이터를 무시하고 흘려 버린다

FolderExists

특정 폴더의 존재 여부를 체크한다.

IsFileItem

선택한 폼 데이터의 종류가 파일인지 확인한다. 파일이라면 TRUE를 리턴한다.

IsImageItem

선택한 폼 데이터의 종류가 이미지 파일인지 확인한다. 이미지 파일이라면 TRUE를 리턴한다.

Save

업로드 된 파일을 원래 파일명과 동일한 이름으로 디폴트 경로 또는 지정한 경로에 저장 한다.

SaveVirtual

업로드 된 파일을 원래 파일명과 동일한 이름으로 지정한 가상경로에 저장 한다.

SaveAs

업로드 된 파일을 새 이름으로 지정한 경로에 저장 한다.

SaveAsVirtual

업로드 된 파일을 새 이름으로 지정한 가상경로에 저장 한다.

SaveAsBlob

업로드 된 파일을 Database BLOB필드에 저장 한다.

SetProgress

DEXT.Progress 객체의 GetProgressID 메소드가 넘겨준 값을 설정한다.

 

 

  FileDownload 객체

서버에 있는 파일 또는 데이터베이스 BLOB필드에 있는 이진데이터를 웹 브라우저를 통해 클라이언트 사용자의 하드디스크 파일로 다운로드 할 수 있는 기능을 가진 개체이다.


메소드

이 름

설 명

Download

서버에 있는 파일을 웹 브라우저를 통해 클라이언트 사용자에게로 다운로드 한다

DownloadVirtual

서버의 가상경로에 있는 파일을 웹 브라우저를 통해 클라이언트 사용자 에게로 다운로드 한다.

DownloadBlob

Database에 있는 BLOB 데이터를 웹 브라우저를 통해 클라이언트 사용자 에게로 다운로드 한다.

 

 

 FileUploadMonitor 객체

고정형 정보 창을 통해서 업로드 진행 상황을 파악할 수 있게 해주는 객체이다.

메소드

이 름

설 명

UseMonitor

업로드 진행상황 모니터링기능의 사용여부를 지정한다.
모니터링 기능을 사용 하고자 할 경우는 반드시 Submit Form을 작성하는 페이지 내에서 UseMonitor(True)를 호출해야 한다.

ShowMonitor

업로드 진행상황을 Progress Bar 로 보여주고, 전체 파일용량, 남은 파일용량, 업로드 속도, 남은 시간 등의 정보를 실시간으로 보여준다.

 

 

 ImageProc 객체

DEXT.ImageProc 객체는 다양한 이미지 포맷(JPG, BMP, GIF, PNG, TIFF, ICON, WMF, EMF )을 지원하며 다른 이미지 포맷으로의 변환도 지원한다.
이미지 파일의 썸네일 이미지를 생성할 수 있다. 생성된 이미지는 JPG 포맷을 가진다.
지정한 이미지나 글자를 이용해서 워터마크 이미지를 생성할 수 있다.
노출 시간, 이미지 설명, 해상도 등 다양한 메타 데이터를 지원한다.


프로퍼티

이 름

설 명

AutoMakeFolder

이것을 TRUE로 설정하면 SaveAsThumbnail(), SaveAsWaterMarkImage() 등에 지정한 폴더가 존재하지 않을 경우 폴더를 자동으로 생성한다.

BackGroundColor

SaveAsThumbnail() 메소드를 호출 시 자동 배율을 선택한 경우 백 그라운드 색상을 결정할 때 설정한다.

FontFamily

SaveAsWatermarkText() 메소드를 호출 시 프린트 되는 폰트의 폰트체를 결정할 때 설정한다.

FontStyle

SaveAsWatermarkText() 메소드를 호출 시 프린트 되는 폰트의 속성을 결정할 때 설정한다.

 

 0 : FontStyleRegular (일반 텍스트)

 1 : FontStyleBold (굵은 텍스트)

 2 : FontStyleItalic (기울임꼴 텍스트)

 3 : FontStyleBoldItalic (굵은 기울임꼴 텍스트)

 4 : FontStyleUnderline (밑줄이 그어진 텍스트)

 5 : FontStyleStrikeout (중간에 줄이 있는 텍스트)

ImageMirror

이미지의 좌우 반전

ImageRotate

이미지를 오른쪽으로 90도 단위씩 회전해서 표현

(*아래 숫자만 가능)

90  : 오른쪽으로  90도 회전

180 : 오른쪽으로 180도 회전

270 : 오른쪽으로 270도 회전

WatermarkTransparency

워터 마크 이미지의 투명도를 조절해서 표현하는 방식 숫자가 커질수록 투명도가 낮아진다.

ImageFormat

이미지 형식이다. BMP, EMF, EXIF, GIF, Icon, JPEG, PNG, TIFF, WMF” 중에 하나를 리턴한다. 그 외의 이미지는 “Undefined”를 리턴한다.

PixelFormat

픽셀 포맷

ImageWidth

이미지 넓이

ImageHeight

이미지 높이

HorizontalResolution

수평 해상도

VerticalResolution

수직 해상도

MDDocumentName

이미지의 이름

MDImageDescription

이미지 설명

MDEquipMake 

카메라 제조사

MDEquipModel

카메라 모델명

MDSoftwareUsed

이미지 파일을 생성한 프로그램

MDDateTimeOrig

촬영 일자

MDDateTime

수정 일자

MDArtist

촬영자

MDExifShutterSpeed

셔터 속도

MDExifExposureTime

노출 시간 (셔터 속도)

MDExifFNumber

조리개 값 "F/?.?f" 형식을 리턴한다.

MDExifMaximumLensAperture

최대 조리개 값

MDExifColorSpace

색상모드 “sRGB, uncalibreated, reserved” 중에 하나를 리턴한다.

MDExifFlash

플래쉬 사용

 

0 flash did not fire

1 flash fired

2 flash fired but strobe return light not detected

3 flash fired and strobe return light detected

MDExifISOSpeed

ISO 속도

MDExifFocalLength

초점 거리

MDExifFocalLengthIn35mm

35mm 필름 초점 거리

MDExifExposureProg

촬영 모드(노출 프로그램)

 

0 - Not defined

1 - Manual

2 - Normal program

3 - Aperture priority

4 - Shutter priority

5 - Creative program (biased toward depth of field)

6 - Action program (biased toward fast shutter speed)

7 - Portrait mode (for close-up photos with the background out of focus)

8 - Landscape mode (for landscape photos with the background in focus)

9 to 255 - Reserved

MDExifExposureBias

노출 보정

MDExifExifDigitalZoomRatio

디지털 줌

MDExifMeteringMode

측광모드

MDExifLightSource

광원

 

0 - Unknown lighting

1 - Daylight

2 - Fluorescent lighting

3 - Tungsten lighting

17 - Standard Light A

18 - Standard Light B

19 - Standard Light C

20 - D55 light

21 - D65 light

22 - D75 light

23 to 254 - Reserved

255 - Other lighting

MDExifWhiteBalance

화이트 밸런스 ("Auto", "Manual", "Unknown")

Quality

JPEG 파일의 선명도 조절 (범위 : 1~100)


메소드

이 름

설 명

SetSourceFile

작업의 대상이 되는 이미지 파일을 설정한다. 이 메서드를 성공적으로 호출한 후에 아래의 함수들을 호출 할 수 있다.

SaveAsThumbnail 

썸네일 이미지를 생성한다. 썸네일의 포맷은 JPG이다. 리턴 값은 실제로 저장된 경로를 포함하는 파일의 이름이다.

SaveAsWatermarkImage

이미지를 이용한 워터마크 이미지를 생성한다. 워터마크 된 파일의 포맷은 JPG.

SaveAsWatermarkText

텍스트를 이용한 워터마크 이미지를 생성한다. 워터마크 된 파일의 포맷은 JPG.

ConvertImageFormat 

이미지 포맷을 지정된 파일로 변환한다. 첫 번째 인자는 변환할 이미지 포맷으로 “image/jpeg, image/bmp” 등으로 입력한다.

[출처] DEXT.FileUpload API|작성자 리베리오