Microsoft Excel 커넥터 방법

오픈

입력에 따라 기존 Microsoft 파일을 작성하거나 엽니다.

주:

다른 메서드보다 먼저 이 메서드를 실행해야 합니다.

표 1. Open 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
파일 경로	메서드가 열리는 기존 파일의 경로입니다. 파일을 만들려면 CreateNewFile 매개 변수의 값을 True로 설정해야 합니다. 주: 경로에는 파일 이름이 포함되어야 합니다.	의 데이터	문자열	없음	예
새 파일 만들기	파일을 작성합니다. 파일을 만들려면 값을 True로 설정하고 Filepath 매개 변수에 파일 경로와 파일 이름을 제공합니다.	의 데이터	부울	없음	아니요
DisplayAlerts (디스플레이 경보)	파일을 열거나 만들 때 작업 표시줄에 경고를 표시합니다. 경고를 표시하려면 값을 True로 설정한 다음 IsVisible 매개 변수의 값을 True로 설정합니다.	의 데이터	부울	없음	아니요
IsVisible (영문)	DisplayAlerts 매개 변수와 함께 작동하여 파일을 열거나 만들 때 작업 표시줄에 경고를 표시합니다. 경고를 표시하려면 값을 True로 설정한 다음 DisplayAlerts 매개 변수의 값을 True로 설정합니다.	의 데이터	부울	없음	아니요
ReadOnlyMode (읽기 전용 모드)	값이 True이면 메서드는 파일을 읽기 전용 모드로 열고, 그렇지 않으면 파일을 편집 가능한 모드로 엽니다.	의 데이터	부울	없음	아니요
암호	문서가 암호로 보호되어 있는 경우 암호를 사용합니다.	의 데이터	문자열	없음	아니요
반환	값이 True이면 파일이 열리거나 만들어지고, 그렇지 않으면 값은 False입니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

AddNewWorkSheet (영문)

파일에 워크시트를 추가합니다.

주:

이 메서드를 실행하기 전에 Open 메서드를 실행해야 합니다.

표 2. AddNewWorkSheet 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	메서드가 파일에 추가하는 워크시트의 이름입니다.	의 데이터	문자열	없음	예

시트 이름 가져오기

열려 Microsoft 있는 Excel 문서에 있는 시트의 이름을 반환합니다.

주:

이 메서드를 실행하기 전에 Open 메서드를 실행해야 합니다.

표 3. GetSheetNames 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
반환	열려 Microsoft 있는 Excel 문서에 있는 시트의 이름을 반환합니다.	데이터 출력	문자열	기본값 없음	해당 사항 없음

닫기

활성 Microsoft Excel 문서를 닫습니다.

주:

이 메서드를 실행하기 전에 Open 메서드를 실행해야 합니다.

표 4. Close 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
변경 내용 저장	값을 True로 설정하면 파일에 대한 변경 내용이 닫히기 전에 저장됩니다. 그렇지 않고 False로 설정하면 변경 내용이 저장되지 않습니다.	의 데이터	부울	없음	아니요

ColumnsCount (영문)

활성 Microsoft Excel 파일의 워크시트에 있는 총 열 수를 반환합니다.

주:

이 메서드를 실행하기 전에 Open 메서드를 실행해야 합니다.

표 5. ColumnsCount 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	메서드가 열 수를 계산하는 데 사용하는 시트의 이름입니다.	의 데이터	문자열	없음	예
반환	워크시트의 열 개수를 반환합니다.	데이터 출력	정수	해당 사항 없음	해당 사항 없음

복사

워크시트의 셀 범위에서 내용을 복사합니다.

팁:

복사한 내용은 Paste 메서드를 사용하여 붙여넣을 수 있습니다.

표 6. 메서드 매개변수 복사
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	메서드가 셀 내용을 복사하는 시트의 이름입니다.	의 데이터	문자열	없음	예
셀레인지	메서드가 내용을 복사하는 셀의 범위입니다.	의 데이터	문자열	없음	예

차트 작성

열린 Microsoft Excel 문서에 지정된 차트 유형을 만듭니다.

주:

이 메서드 전에 Open 메서드를 실행해야 합니다.

표 7. CreateChart 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	차트가 만들어지는 시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
셀레인지(CellRange)	메서드가 차트를 만들기 위해 데이터를 가져오는 셀의 범위입니다.	데이터 입력	문자열	기본값 없음	예
차트 유형	생성될 차트의 유형입니다.	데이터 입력	엑셀차트타입	기본값 없음	예
반환	True이면 차트가 성공적으로 작성된 것입니다. 그렇지 않고 False인 경우 차트 생성에 실패한 것입니다.	데이터 출력	부울	기본값 없음	해당 사항 없음

DeleteColumn입니다.

지정된 인덱스를 기준으로 열을 삭제합니다.

표 8. DeleteColumn 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	열이 삭제되는 시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
열 인덱스	메서드가 삭제할 열의 인덱스입니다.	데이터 입력	정수	기본값 없음	예
반환	열이 삭제되었는지 여부를 나타내는 부울 값을 반환합니다. True이면 열이 삭제됩니다. 그렇지 않으면 False인 경우 열이 삭제되지 않습니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

DeleteContentFromRange (영문)

지정된 셀 범위에서 내용을 삭제합니다.

표 9. DeleteContentFromRange 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	컨텐츠를 삭제할 시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
셀레인지(CellRange)	열 아래의 셀 범위입니다.	데이터 입력	문자열	기본값 없음	예
반환	내용이 삭제되었는지 여부에 대한 부울 값을 반환합니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

DeleteEmptyColumns (영문)

내용이 없는 열을 삭제합니다.

표 10. DeleteEmptyColumns 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	빈 열이 포함된 시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예

DeleteEmptyRows (영문)

지정된 워크시트에서 빈 행을 삭제합니다.

표 11. DeleteEmptyColumns 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	빈 행이 포함된 시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예

행 삭제(DeleteRow)

지정된 인덱스를 기준으로 행을 삭제합니다.

표 12. DeleteRow 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	행을 삭제할 시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
행 인덱스	삭제될 행의 인덱스입니다.	데이터 입력	정수	기본값 없음	예
반환	행이 삭제되었는지 여부를 나타내는 부울 값을 반환합니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

DeleteWorksheet (워크시트) 삭제

지정된 워크시트를 삭제합니다.

표 13. DeleteWorksheet 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	삭제될 시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
반환	워크시트가 삭제되었는지 여부를 나타내는 부울 값을 반환합니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

ExportChartAsImages (영문)

지정된 워크시트의 차트를 지정된 위치에 이미지로 내보냅니다.

표 14. ExportChartAsImages 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	차트가 들어 있는 시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
폴더 경로 저장	차트가 저장될 로컬 드라이브의 경로입니다.	데이터 입력	문자열	기본값 없음	해당 사항 없음

PDF로 익스포트

열린 Excel 문서의 내용을 PDF로 내보냅니다.

표 15. ExportChartAsImages 메서드 매개변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
파일 경로	PDF를 익스포트하는 로컬 드라이브의 경로입니다.	데이터 입력	문자열	기본값 없음	예

찾기와 바꾸기

지정된 워크시트에서 텍스트를 찾아 바꿉니다.

표 16. FindAndReplace 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	텍스트를 바꿀 워크시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
텍스트 찾기	대체될 텍스트입니다.	데이터 입력	문자열	기본값 없음	예
ReplaceTo	기존 텍스트를 대체할 텍스트입니다.	데이터 입력	문자열	기본값 없음	예
반환	텍스트가 대체되었는지 여부를 나타내는 부울 값을 반환합니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

GetActiveSheetName (영문)

활성 워크시트의 이름을 반환합니다.

표 17. GetActiveSheetName 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
반환	활성 워크시트의 이름을 반환합니다.	데이터 출력	문자열	기본값 없음	해당 사항 없음

새 열 삽입

워크시트의 지정된 인덱스에 새 열을 삽입합니다.

표 18. InsertNewColumn 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	열을 삽입할 워크시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
열 인덱스	새 열의 인덱스입니다. 새 열이 지정된 인덱스에 삽입됩니다.	데이터 입력	정수	기본값 없음	예

새 행 삽입

지정된 워크시트의 지정된 인덱스에 새 행을 삽입합니다.

표 19. InsertNewRow 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	행을 삽입할 워크시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
행 인덱스	행의 인덱스입니다. 행이 지정된 인덱스에 삽입됩니다.	데이터 입력	정수	기본값 없음	예
반환	행이 삽입되었는지 여부를 나타내는 부울 값을 반환합니다. True이면 행이 삽입됩니다. 그렇지 않으면 False이면 행이 삽입되지 않습니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

오브젝트 삽입

Excel 파일에 있는 시트의 지정된 셀에 개체를 삽입합니다. 객체의 예로는 Excel 파일, 이미지 또는 PDF 파일이 있을 수 있습니다.

주:

이 메서드를 실행하기 전에 Open 메서드를 실행합니다.

표 20. InsertObject 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	메서드가 개체를 삽입하는 셀이 들어 있는 Excel 시트입니다.	데이터 입력	문자열	해당 사항 없음	예
셀 이름	메서드가 개체를 삽입하는 셀의 이름입니다. 예: A1.	데이터 입력	문자열	해당 사항 없음	예
파일 경로	메서드가 삽입하는 개체의 파일 경로입니다.	데이터 입력	문자열	해당 사항 없음	예

오픈(IsOpen)

지정된 Excel 파일이 열려 있는지 여부에 대한 부울 값을 반환합니다.

표 21. IsOpen 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
파일 경로	로컬 드라이브에 있는 Excel 파일의 경로입니다.	데이터 입력	문자열	기본값 없음	예
반환	Excel 파일이 열려 있는지 여부를 나타내는 부울 값을 반환합니다.	데이터 출력	부울	해당 사항 없음	해당 사항 없음

머지셀

범위에 지정된 셀을 병합합니다.

표 22. MergeCells 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	셀을 병합할 워크시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
셀레인지(CellRange)	셀의 범위입니다. 범위 내의 모든 셀이 병합됩니다.	데이터 입력	문자열	기본값 없음	예

범위에서 읽기

지정된 워크시트에서 데이터를 읽고 데이터를 반환합니다.

표 23. ReadFromRange 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	메서드가 데이터를 읽을 워크시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
셀레인지(CellRange)	셀의 범위입니다. 메서드는 이러한 셀에서 데이터를 읽습니다.	데이터 입력	문자열	기본값 없음	예
FirstRowAs헤더	메서드에서 첫 번째 행을 헤더로 처리하는지 여부를 나타내는 부울 값입니다. True이면 첫 번째 행이 헤더로 처리됩니다. 그렇지 않으면 False인 경우 첫 번째 행을 헤더로 처리하지 않습니다.	데이터 입력	부울	기본값 없음	아니요
반환	셀의 데이터를 구성하는 데이터 테이블을 반환합니다.	데이터 출력	데이터 테이블	해당 사항 없음	아니요

ReadFromSheet (시트에서 읽기)

지정된 워크시트의 모든 데이터를 반환합니다.

표 24. MergeCells 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	메서드가 데이터를 읽을 워크시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
반환	지정된 워크시트의 모든 데이터를 반환합니다.	데이터 출력	데이터 테이블	해당 사항 없음	해당 사항 없음

RenameSheetName(시트 이름)

기존 워크시트의 이름을 바꿉니다.

표 25. RenameSheetName 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
OldSheetName (영문)	기존 워크시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
NewSheetName입니다	워크시트의 새 이름입니다.	데이터 입력	문자열	기본값 없음	예
반환	워크시트의 이름이 바뀌었는지 여부를 나타내는 부울 응답을 반환합니다.	데이터 출력	부울	기본값 없음	해당 사항 없음

RowsCount (영문)

지정된 워크시트의 행 수를 반환합니다.

표 26. RenameSheetName 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	행 수가 반환될 워크시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
반환	행 수를 반환합니다.	데이터 출력	정수	해당 사항 없음	해당 사항 없음

필터 제거

Excel 문서에 설정된 모든 필터를 제거합니다.

표 27. RemoveFilter 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	메서드가 필터를 제거할 워크시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예

저장

Excel 문서에 변경 내용을 저장합니다.

범위 쓰기(WriteToRange)

지정된 범위에 데이터를 씁니다.

표 28. RemoveFilter 메서드 매개 변수
매개변수	설명	데이터 포트 유형	데이터 유형	기본값	필수?
시트 이름	데이터가 기록되는 워크시트의 이름입니다.	데이터 입력	문자열	기본값 없음	예
셀 이름	데이터가 기록되는 셀의 이름입니다.	데이터 입력	문자열	기본값 없음	예
데이터	기록될 데이터입니다.	데이터 입력	데이터 테이블	기본값 없음	예
IncludeHeaders	데이터 테이블의 헤더가 추가될지 여부를 나타내는 부울 값입니다.	데이터 입력	부울	기본값 없음	아니요