프로그램&DB/ASP
[ASP] DEXT.FileUpload API (FileUpload, FileDownload, FileUploadMonitor, ImageProc)
Josep.H.S
2011. 8. 11. 13:24
■ 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
제품에 해당)
|
메소드
|
■ 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)
|
메소드
|