xplusfilewrite

해당 하는 파일에 내용을 기록하는 API이다. 파일이 존재하지 않는 경우 새로 생성하여 기록합니다.

strFilePath 파라미터에 빈 문자열("") 입력시, 파일선택대화상자를 표시합니다.

strCharSet 파라미터는 옵션 파라미터로 기록할 캐릭터셋을 지정한다. 값을 주지 않을 경우는
ANSI로 기록합니다. 다른 캐릭터셋을 지정하고자 할 경우 Remark참조.

bIncludeBOM 파라미터는 옵션 파라미터로 유니코드(UTF8, UTF16등)로 저장시 파일의 BOM(Byte Order Mark) 정보를 기록 할지 여부이다. BOM은 일종의 유니코드파일에 대한 헤더 정보로 어떤 캐릭터셋으로 해당 파일이 기록 되어 있는지를 표시해준다. 해당 값은 편집기에서는 보여지지 않는 값이며 값을 주지 않을 경우는 BOM정보를 기본적으로 파일에 포함시킨다.

Parameters	Type	Description
strFilePath	STRING	파일 경로
strContent	STRING	저장할 파일 내용
nWriteOption	short	저장 옵션 상수(*Remark 참조)
strCharSet	STRING	[옵션] 저장할 캐릭터셋 지정(기본값: '')
bIncludeBOM	BOOL	[옵션] BOM 정보를 포함할지 여부(기본값: true)
bProcDownloadCompleteMsg	BOOL	[옵션] 파일 저장 완로시 파일 다운로드 메시지 처리 여부 (기본값: false)
strAccept	STRING	[옵션] 파일 유형 문자열(기본값: '')

Type	Description
BOOL	정상 적용 여부(true, false)

**nWriteOption 파라미터

XFD_FILEWRITE_OVERWRITE = 0 : 무조건 덮어쓰기
XFD_FILEWRITE_APPEND = 1 : 기존파일이 있는 경우, 내용추가
XFD_FILEWRITE_PROMPT = 2 : 기존파일이 있는 경우, 덮어쓰기여부 확인메시지창 표시(메시지창에서 "아니오(N)"선택시, 파일선택대화상자표시)

* 참고
자바스크립트에서 지원하는 ActiveXObject("Scripting.FileSystemObject") 를 사용하여 파일을 기록하는 경우 윈도우 비스타 계열OS에서는 권한 문제로 오류가 발생할 수 있으므로 윈도우 비스타 계열OS를 지원해야 하는 경우 해당 API를 사용하도록 권장한다. 하지만 해당 API를 사용하더라도 비스타 계열OS에서 시스템관련 디렉토리에는 기록할 수 없다.

ex > c:\, c:\Program Files, c:\Windows..등

** strCharSet 파라미터

저장할 캐릭터셋으로 아래값 입력 가능, 값을 주지 않을경우 Default ANSI로 기록

"UTF16/UCS-2", "UTF16", "UCS-2" : utf16 LE 방식으로 기록
"UTF8"        : utf8로 기록

** bIncludeBOM 파라미터

파일의 처음에 아래와 같은 Byte정보가 기록. 

"UTF16/UCS-2", "UTF16", "UCS-2" : 0xFF, 0xFE (2byte)
"UTF8"        : 0xEF, 0xBB, 0xBF (3byte)

** strAccept 파라미터
파일 유형은 파일목록에서 반환될 파일 유형을 지정한다. 한개 이상의 값을 설정하는 경우에는, 공백없이 콤마(,)로 연결한 값을 지정한다. (예: ".gif,.jpg,.png,.doc")

전용 브라우저 환경에서만 동작합니다.

function btnTest_on_mouseup()
{
	var bSuccess = factory.xplusfilewrite("c:\\xFrame\\test.txt", "34567", XFD_FILEWRITE_OVERWRITE);
	if(bSuccess == true) {
		screen.alert("파일 기록 성공");
	} else {
		screen.alert("파일 기록 실패");
	}
}

function btnTest2_on_mouseup()
{
	var bSuccess = factory.xplusfilewrite("", "34567", XFD_FILEWRITE_OVERWRITE); // 파일선택대화상자 표시
	if(bSuccess == true) {
		screen.alert("파일 기록 성공");
	} else {
		screen.alert("파일 기록 실패");
	}
}

팩토리 » Api

xplusfilewrite

Description

Parameters

Return Value

Remark

Example

See Also

Viewer Ver.

Update Date