[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|작성자 리베리오