Microsoft Excel 커넥터 메서드

커넥터 메서드는 Microsoft Excel 문서에 대해 다양한 작업을 수행합니다.Microsoft Excel 자동화 플로우에서 메서드는 다른 메서드 및 구성요소와 연결됩니다. 메서드를 사용하려면 먼저 메서드를 노출해야 합니다.

오픈

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

주:

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

표 1. 메서드 매개변수 열기

매개변수	설명	데이터 포트 유형	데이터 유형
파일 경로	메서드가 여는 기존 파일의 경로입니다. 파일을 만들려면 CreateNewFile 매개변수의 값을 True로 설정해야 합니다. 주: 경로에는 파일 이름이 포함되어야 합니다.	의 데이터	문자열
새 파일 작성	지정된 파일이 없는 경우 새 Excel 파일을 생성할지 여부를 지정합니다. CreateNewFile 매개변수가 true로 설정되면 지정된 파일 경로에 새 파일이 만들어집니다. 아니오로 설정하면 지정된 파일 경로에서 Excel을 열려고 시도합니다.	의 데이터	부울
경보 표시	여는 프로세스 중에 Excel에서 경보 또는 프롬프트를 표시할지 여부를 지정합니다. true로 설정하면 Excel에서 파일 충돌 또는 호환성 경고와 같은 문제에 대한 경고를 표시합니다. false로 설정하면 이러한 경보가 표시되지 않습니다.	의 데이터	부울
IsVisible	파일을 열 때 사용자에게 Excel 애플리케이션 창이 표시되는지 여부를 지정합니다. true로 설정하면 Excel 창이 화면에 표시됩니다. false로 설정하면 Excel이 표시되는 인터페이스 없이 백그라운드에서 실행됩니다.	의 데이터	부울
ReadOnlyMode	Excel 파일을 읽기 전용 모드로 열어야 하는지 여부를 지정합니다. true로 설정하면 파일이 읽기 전용 모드로 열리므로 변경되지 않습니다. false로 설정하면 파일이 일반 모드로 열리고 수정이 허용됩니다.	의 데이터	부울
암호	암호로 보호된 Excel 파일을 여는 데 암호가 필요합니다. 파일이 암호로 보호되지 않은 경우 이 매개변수를 비워둘 수 있습니다.	의 데이터	문자열
돌아가기	예 또는 아니오 값을 반환합니다. 값이 예이면 파일을 성공적으로 열거나 작성한 것입니다.	데이터 출력	부울

새 작업시트 추가

파일에 새 워크시트를 추가합니다. 이 메서드에는 새 시트의 이름을 지정하는 문자열 유형의 입력 매개변수로 시트 이름이 필요합니다.

주:

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

표 2. AddNewWorkSheet 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	메서드가 파일에 추가하는 새 워크시트의 이름입니다.	의 데이터	문자열

자동 채우기

인접한 셀의 내용이나 미리 정의된 패턴에 따라 지정된 범위 내의 셀을 자동으로 채웁니다. 이 방법은 여러 셀에서 데이터를 복사하거나 서식을 지정하는 데 유용합니다. Microsoft Excel 초기 선택의 내용을 분석하고 원하는 범위를 채우도록 외삽합니다. 일련의 숫자를 확장하거나, 수식을 복제하거나, 텍스트 패턴을 복제하거나, 기타 데이터 입력 처리를 수행하는 데 사용할 수 있습니다.

주:

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

표 3. AutoFill 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	의 데이터	문자열
소스 범위	복제할 데이터 또는 수식이 있는 셀의 범위입니다.	의 데이터	문자열

GetSheetNames

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

주:

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

표 4. GetSheetNames 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
돌아가기	열린 Microsoft Excel 문서의 시트 이름을 반환합니다.	데이터 출력	문자열

닫기

활성 문서가 이미 열려 있는 경우 닫 Microsoft Excel 고 메모리를 해제합니다. 이 방법은 메모리 처리에 도움이 됩니다.

주:

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

표 5. 메서드 매개변수 닫기

매개변수	설명	데이터 포트 유형	데이터 유형
saveChanges	값을 True로 설정하면 닫기 전에 파일의 변경 내용이 저장됩니다. False로 설정하면 변경 내용이 저장되지 않습니다.	의 데이터	부울

ColumnsCount

파일의 지정된 워크시트에서 총 열 수를 반환합니다 Microsoft Excel . 이 메서드를 사용하려면 SheetName 매개 변수가 워크시트를 지정한 다음 해당 시트의 열 카운트를 반환해야 합니다.

주:

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

표 6. ColumnsCount 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	메서드가 열 수를 계산하는 데 사용하는 시트의 이름입니다.	의 데이터	문자열
돌아가기	워크시트의 열 수를 반환합니다.	데이터 출력	정수

복사

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

팁:

복사한 내용을 Paste(붙여넣기) 방법으로 붙여넣을 수 있습니다.

표 7. 메서드 매개변수 복사

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 시트의 이름입니다.	의 데이터	문자열
셀 범위	복사할 셀의 범위입니다.	의 데이터	문자열

붙여넣기

워크시트의 CellLocation 매개변수에 제공된 특정 셀에 클립보드 내용을 붙여넣습니다. 또한 세포의 범위가 될 수도 있습니다.

주:

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

표 8. 메서드 매개변수 붙여넣기

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	클립보드 콘텐츠를 붙여넣을 시트의 이름입니다.	의 데이터	문자열
셀 위치	클립보드 콘텐츠를 붙여넣을 위치(셀 참조)를 나타냅니다.	의 데이터	문자열

FillBlankValues

파일의 워크시트 Microsoft Excel 내 지정된 열에 있는 빈 셀을 지정된 값으로 채웁니다. 워크시트를 지정하는 SheetName 매개변수, 열을 식별하는 ColumnName 매개변수, 빈 셀의 대체 값을 제공하는 Value 매개변수가 필요합니다.

주:

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

표 9. FillBlankValues 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	빈 값을 채울 시트의 이름입니다.	의 데이터	문자열
열 이름	값으로 채워야 하는 워크시트의 열 이름입니다. ColumnName은 A에서 AZ까지의 Excel 열을 나타내는 Enum 데이터 형식입니다.	의 데이터	열 이름
값	열에 채울 값입니다.	의 데이터	문자열

차트 작성

특정 워크시트의 특정 범위에 대한 차트를 작성합니다. 이 방법은 차트 생성을 자동화하는 데 사용됩니다.

주:

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

표 10. CreateChart 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	차트가 생성된 시트의 이름입니다.	데이터 입력	문자열
셀 범위	차트가 생성되는 셀의 범위입니다.	데이터 입력	문자열
차트 유형	작성할 차트의 유형을 지정합니다. 사용 가능한 차트 유형은 사용 중인 Excel 커넥터의 특정 구현에 따라 다릅니다.	데이터 입력	ExcelChartType
돌아가기	예일 경우 차트가 성공적으로 작성된 것입니다. False인 경우 차트를 작성하지 못합니다.	데이터 출력	부울

피벗 테이블 생성

"피벗 테이블 설정" 창에서 구성된 설정을 활용하여 지정된 시트에 피벗 테이블을 생성합니다.

주:

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

표 11. CreatePivotTable 메서드 매개 변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	피벗 테이블을 만들어야 하는 시트의 이름입니다.	데이터 입력	문자열
피벗 테이블 이름	피벗 테이블의 이름입니다.	데이터 입력	문자열

DeleteColumn

열의 지정된 인덱스에 따라 지정된 시트의 열을 삭제합니다.

표 12. DeleteColumn 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	열이 삭제되는 시트의 이름입니다.	데이터 입력	문자열
ColumnIndex	삭제해야 하는 열의 인덱스입니다. Excel에서 열에는 알파벳순(A, B, C 등)으로 레이블이 지정되며 각 열에는 해당 숫자 인덱스(A 열의 경우 1, B 열의 경우 2 등)가 있습니다.	데이터 입력	정수
돌아가기	열이 삭제되었는지 여부를 나타내는 부울 값을 반환합니다. 예일 경우 열이 삭제됩니다. False인 경우 열이 삭제되지 않았습니다.	데이터 출력	부울

DeleteContentFromRange

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

표 13. DeleteContentFromRange 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	컨텐츠를 삭제할 시트의 이름입니다.	데이터 입력	문자열
셀 범위	데이터가 삭제되는 셀의 범위를 지정합니다.	데이터 입력	문자열
돌아가기	셀 범위의 콘텐츠가 삭제되었는지 여부를 나타내는 부울 값을 반환합니다. 예일 경우 콘텐츠가 삭제됩니다. False인 경우 콘텐츠가 삭제되지 않습니다.	데이터 출력	부울

DeleteEmptyColumns

파일의 지정된 워크시트에 컨텐츠가 없는 열을 삭제합니다 Microsoft Excel . 이 메서드는 워크시트를 식별하기 위해 SheetName 매개변수가 필요합니다.

표 14. DeleteEmptyColumns 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	빈 열이 포함된 시트의 이름입니다.	데이터 입력	문자열

DeleteEmptyRows

파일의 지정된 워크시트에 컨텐츠가 없는 행을 삭제합니다 Microsoft Excel . 이 메서드는 워크시트를 식별하기 위해 SheetName 매개변수가 필요합니다.

표 15. DeleteEmptyColumns 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	빈 행이 포함된 시트의 이름입니다.	데이터 입력	문자열

Delete행

RowNumber 매개변수를 기반으로 워크시트에서 행을 삭제합니다.

표 16. DeleteRow 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	행이 삭제되는 시트의 이름입니다.	데이터 입력	문자열
행번호	삭제해야 하는 행의 번호를 나타냅니다.	데이터 입력	정수
돌아가기	행이 삭제되었는지 여부를 나타내는 부울 값을 반환합니다. True이면 행이 삭제됩니다. False인 경우 행은 삭제되지 않습니다.	데이터 출력	부울

작업 시트 삭제

지정된 워크시트를 삭제합니다. 이 메서드는 워크시트를 식별하기 위해 SheetName 매개변수가 필요합니다.

표 17. DeleteWorksheet 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	삭제해야 하는 시트의 이름입니다.	데이터 입력	문자열
돌아가기	워크시트가 삭제되었는지 여부를 나타내는 부울 값을 반환합니다. 예일 경우 워크시트가 삭제됩니다. False인 경우 워크시트가 삭제되지 않습니다.	데이터 출력	부울

ExportChartAsImages

시트에 있는 차트를 지정된 경로에 저장된 이미지 파일로 익스포트하고 저장합니다. 이 프로세스는 차트를 Excel 통합 문서와 분리하여 다양한 문서, 프레젠테이션 또는 보고서에 쉽게 공유하거나 삽입할 수 있는 독립 실행형 시각적 표현을 제공합니다.

표 18. ExportChartAsImages 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	차트가 포함된 시트의 이름입니다.	데이터 입력	문자열
SaveFolder경로	차트가 이미지 파일로 저장되는 폴더 경로를 지정합니다.	데이터 입력	문자열

PDF로 익스포트

Excel 파일을 PDF 파일로 FilePath 매개변수에 언급된 경로 위치로 내보냅니다.

표 19. ExportToPDF 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
파일 경로	PDF 파일을 익스포트할 파일 경로를 지정합니다.	데이터 입력	문자열

찾기 및 바꾸기

SheetName 매개변수로 지정된 워크시트의 FindText 매개변수에 지정된 텍스트를 찾아 ReplaceTo 매개변수에 지정된 다른 텍스트로 바꿉니다.

표 20. FindAndReplace 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	텍스트를 바꿀 워크시트의 이름입니다.	데이터 입력	문자열
텍스트 찾기	워크시트의 셀 내에서 검색되는 텍스트입니다.	데이터 입력	문자열
ReplaceTo	FindText 매개변수를 사용하여 찾은 텍스트를 대체할 텍스트입니다.	데이터 입력	문자열
돌아가기	텍스트가 대체되었는지 여부를 나타내는 부울 값을 반환합니다. 예일 경우 텍스트가 바뀝니다. False인 경우 텍스트가 바뀌지 않습니다.	데이터 출력	부울

GetActiveSheetName

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

표 21. GetActiveSheetName 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
돌아가기	활성 워크시트의 이름을 문자열 형식으로 반환합니다.	데이터 출력	문자열

GetCellAddressIfRowHas

지정된 시트에서 지정된 텍스트를 검색합니다. 표시된 행 인덱스에서 시작하여 지정된 열 이름을 스캔합니다. 텍스트가 발견되면 true를 반환합니다. 그렇지 않으면 false를 반환합니다. 또한 일치하는 셀 주소를 구성된 값에 저장할 수 있습니다.

주:

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

표 22. GetCellAddressIfRowHas 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	검색할 워크시트의 이름입니다.	데이터 입력	문자열
SearchText	지정된 열 내에서 검색할 텍스트입니다.	데이터 입력	문자열
검색 열	검색을 수행할 열입니다. ColumnName은 A에서 AZ까지의 Excel 열을 나타내는 Enum 데이터 형식입니다.	데이터 입력	열 이름
StartRowIndex	검색을 시작할 행 인덱스입니다.	데이터 입력	정수
돌아가기	SearchText를 찾았는지 여부를 나타내는 부울 값을 반환합니다. 예일 경우 텍스트가 발견됩니다. False인 경우 텍스트를 찾을 수 없습니다.	데이터 출력	부울

GetCell수식

워크시트에서 셀 수식을 검색합니다.

주:

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

표 23. GetCellFormula 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	셀 수식을 검색할 워크시트의 이름입니다.	데이터 입력	문자열
셀 이름	수식을 검색할 셀의 이름 또는 참조를 지정합니다.	데이터 입력	문자열
돌아가기	지정된 셀 수식을 문자열 형식으로 반환합니다.	데이터 출력	문자열

GetCellValue

CellName 매개변수로 지정된 워크시트에서 셀의 값을 검색합니다.

주:

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

표 24. GetCellValue 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	셀 값을 검색할 워크시트의 이름입니다.	데이터 입력	문자열
셀 이름	GetCellValue에 설정된 구성에 따라 셀 값을 반환하거나 텍스트를 표시합니다.	데이터 입력	문자열
돌아가기	지정된 셀의 값을 문자열 형식으로 반환합니다.	데이터 출력	문자열

GetCellValueIfRowHas

지정된 시트에서 지정된 텍스트를 검색합니다. 표시된 행 인덱스부터 시작하여 지정된 열을 스캔합니다. 텍스트가 발견되면 true를 반환합니다. 그렇지 않으면 false를 반환합니다. 또한 일치하는 셀 값을 구성된 값에 저장할 수 있습니다.

주:

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

표 25. GetCellAddressIfRowHas 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	검색할 워크시트의 이름입니다.	데이터 입력	문자열
SearchText	지정된 열 내에서 검색할 텍스트입니다.	데이터 입력	문자열
검색 열	검색이 수행되는 열입니다. ColumnName은 A에서 AZ까지의 Excel 열을 나타내는 Enum 데이터 형식입니다.	데이터 입력	열 이름
StartRowIndex	검색이 시작되는 행 인덱스입니다.	데이터 입력	정수
돌아가기	SearchText를 찾았는지 여부를 나타내는 부울 값을 반환합니다. 예일 경우 텍스트가 발견됩니다. False인 경우 텍스트를 찾을 수 없습니다.	데이터 출력	부울

GetCellValues

워크시트의 셀 값을 반환합니다.

주:

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

표 26. GetCellValues 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	데이터 입력	문자열

색상 가져오기

워크시트의 CellName 매개변수에 지정된 셀의 RGB 값을 반환합니다.

주:

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

표 27. GetColor 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	셀 색을 검색할 워크시트의 이름입니다.	데이터 입력	문자열
셀 이름	색상을 검색할 셀의 이름 또는 참조입니다.	데이터 입력	문자열
돌아가기	지정된 셀의 색을 문자열 형식으로 반환합니다.	데이터 출력	문자열

GetColumnNameByIndex

지정된 열 번호에 해당하는 열 이름을 반환합니다. 예를 들어 1은 "A"에 해당합니다.

주:

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

표 28. GetColumnNameByIndex 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
열 번호	이름을 검색할 열 번호입니다.	데이터 입력	정수
돌아가기	열 이름을 문자열 형식으로 반환합니다.	데이터 출력	문자열

GetFilterData

지정된 필터 기준에 따라 워크시트에서 필터링된 데이터를 반환합니다. 데이터는 RowNumber 매개변수에 제공된 행 번호부터 가져옵니다.

주:

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

표 29. GetFilterData 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	데이터 입력	문자열
행번호	데이터 추출을 위한 시작 행인 행의 행 번호입니다.	데이터 입력	정수
FirstRowAsHeader	필터링된 데이터의 첫 번째 행을 헤더 행으로 처리할지 여부를 결정합니다. 예로 설정하면 첫 번째 행은 헤더 행으로 간주되고 추출된 데이터 행에 포함되지 않습니다. false로 설정하면 첫 번째 행이 추출된 데이터 행의 일부로 포함됩니다.	데이터 입력	부울
돌아가기	필터링된 데이터를 테이블 형식으로 반환합니다. 이 테이블의 행과 열에서 작업을 수행할 수 있습니다.	데이터 출력	데이터 테이블

GetFilteredDataAddress

SheetName 매개변수에 제공된 워크시트에서 필터링된 데이터의 주소를 반환합니다.

주:

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

표 30. RowsCount 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	필터링된 데이터의 주소를 검색할 워크시트의 이름입니다.	데이터 입력	문자열
돌아가기	문자열이 필터링된 데이터 주소인 문자열의 목록 또는 컬렉션을 반환합니다.	데이터 출력	목록(문자열 포함)

GetRowValues

값을 추출할 지정된 SheetName 매개변수에서 셀 값을 반환합니다. 기본적으로 RowNumber를 지정하지 않으면(또는 -1로 설정) 마지막 행의 값을 읽습니다. 또한 출력 매개변수를 포함하여 열 이름을 추가하고 해당 값을 출력에 저장할 수 있습니다.

주:

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

표 31. GetRowValues 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	값을 검색할 워크시트의 이름을 지정합니다.	데이터 입력	문자열
행번호	값을 읽을 행입니다. -1로 설정하면 기본값이 마지막 행으로 설정됩니다.	데이터 입력	정수

GetSelectedRange

SheetName 매개변수에 지정된 워크시트에서 현재 선택된 셀 범위를 반환합니다. 강조 표시되거나 선택된 워크시트의 특정 영역에서 데이터가 추출됩니다.

주:

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

표 32. GetSelectedRange 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	데이터 입력	문자열
돌아가기	시트에서 선택한 셀 범위를 문자열 형식으로 반환합니다.	데이터 출력	문자열

GetSheetNames

Excel 파일에 있는 모든 워크시트 이름의 목록을 반환합니다.

주:

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

표 33. GetSheetNames 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
돌아가기	사용 가능한 모든 시트 이름을 문자열 배열 형식으로 반환합니다.	데이터 출력	문자열[]

GetUsedRange

지정된 시트의 사용된 셀 범위를 반환합니다.

주:

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

표 34. GetUsedRange 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	범위를 읽을 워크시트의 이름입니다.	데이터 입력	문자열
헤더 포함	헤더를 포함해야 하는지 여부를 나타냅니다.	데이터 입력	부울
돌아가기	사용된 셀의 범위를 문자열 형식으로 반환합니다.	데이터 출력	문자열

GetValuesByColumn

Distinct, FirstRowAsHeader 및 ValueType 매개변수 기준에 따라 지정된 SheetName의 지정된 ColumnName에서 값의 목록을 반환합니다.

주:

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

표 35. GetValuesByColumn 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	데이터 입력	문자열
열 이름	값이 검색되는 열의 이름을 나타냅니다. ColumnName은 A에서 AZ까지의 Excel 열을 나타내는 Enum 데이터 형식입니다.	데이터 입력	열 이름
FirstRowAsHeader	지정된 열의 첫 번째 행에 머리글이 포함되어 있는지 여부를 나타냅니다.	데이터 입력	부울
고유	검색된 값이 고유해야 하는지 또는 고유해야 하는지 여부를 지정합니다.	데이터 입력	부울
값 유형	가시성을 기준으로 값을 추출합니다.	데이터 입력	가치T
돌아가기	행 수를 반환합니다.	데이터 출력	정수

새 열 삽입

지정된 워크시트의 ColumnNumber 매개변수에 제공된 인덱스에 새 열을 삽입합니다.

표 36. InsertNewColumn 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	열을 삽입해야 하는 워크시트의 이름입니다.	데이터 입력	문자열
ColumnIndex	새 열이 삽입되는 열의 인덱스를 지정합니다. 예를 들어 1은 A, 2는 B입니다.	데이터 입력	정수

새 행 삽입

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

표 37. InsertNewRow 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	행을 삽입할 워크시트의 이름입니다.	데이터 입력	문자열
행 인덱스	행의 인덱스입니다. 행은 지정된 인덱스에 삽입됩니다.	데이터 입력	정수
돌아가기	행이 삽입되었는지 여부를 나타내는 부울 값을 반환합니다. True이면 행이 삽입됩니다. False인 경우 행이 삽입되지 않습니다.	데이터 출력	부울

개체 삽입

지정된 워크시트의 CellName 매개변수에서 인덱스 값으로 식별되는 셀에 포함된 객체를 삽입합니다. 포함된 개체의 경로는 Filepath 매개 변수에 제공됩니다. 개체의 예는 Excel 파일, 이미지 또는 PDF 파일이 될 수 있습니다.

주:

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

표 38. InsertObject 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	메서드가 객체를 삽입하는 워크시트의 이름입니다.	데이터 입력	문자열
셀 이름	메서드가 객체를 삽입하는 셀의 이름입니다. 예: A1.	데이터 입력	문자열
파일 경로	메서드가 삽입하는 객체의 파일 경로입니다.	데이터 입력	문자열

IsOpen

Filepath 매개변수에 제공된 위치의 통합 문서 또는 파일이 열려 있는지 여부를 확인합니다 Microsoft Excel .

표 39. IsOpen 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
파일 경로	로컬 드라이브의 Excel 파일 경로입니다.	데이터 입력	문자열
돌아가기	Excel 파일이 열려 있는지 여부를 나타내는 부울 값을 반환합니다. True이면 Excel 파일이 열립니다. False인 경우 Excel 파일이 열리지 않습니다.	데이터 출력	부울

MergeCells

지정된 워크시트의 범위에 지정된 셀을 병합합니다.

표 40. MergeCells 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	셀을 병합할 워크시트의 이름입니다.	데이터 입력	문자열
셀 범위	셀의 범위입니다. 범위 내의 모든 셀이 병합됩니다.	데이터 입력	문자열

범위에서 읽기

지정된 워크시트에서 데이터를 검색하여 반환합니다. 셀 범위를 추출할 워크시트를 나타내고, 읽을 셀 범위를 결정하기 위해 셀 범위를 지정하고, 첫 번째 행이 FirstRowAsHeader 매개변수의 헤더인지 여부를 나타내기 위해 워크시트 이름을 제공해야 합니다.

표 41. ReadFromRange 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	메서드가 데이터를 읽는 워크시트의 이름입니다.	데이터 입력	문자열
셀 범위	셀의 범위입니다. 메서드는 이러한 셀에서 데이터를 읽습니다.	데이터 입력	문자열
FirstRowAsHeader	메서드가 첫 번째 행을 헤더로 처리하는지 여부를 나타내는 부울 값입니다. True인 경우 첫 번째 행이 헤더로 처리됩니다. False인 경우 첫 번째 행은 헤더로 처리되지 않습니다.	데이터 입력	부울
돌아가기	셀의 데이터를 구성하는 데이터 테이블을 반환합니다.	데이터 출력	데이터 테이블

ReadFromSheet

워크시트에서 데이터를 추출하여 DataTable과 같은 구조화된 형식으로 변환합니다.

표 42. ReadFromSheet 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	메서드가 데이터를 읽는 워크시트의 이름입니다.	데이터 입력	문자열
돌아가기	지정된 워크시트의 모든 데이터를 반환합니다.	데이터 출력	데이터 테이블

시트 이름 바꾸기

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

표 43. RenameSheetName 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
OldSheetName	워크시트의 기존 이름입니다.	데이터 입력	문자열
새 시트 이름	워크시트의 새 이름입니다.	데이터 입력	문자열
돌아가기	워크시트의 이름이 바뀌었는지 여부를 나타내는 부울 응답을 반환합니다. 예일 경우 워크시트의 이름이 바뀝니다. False인 경우 워크시트의 이름이 바뀌지 않습니다.	데이터 출력	부울

행수

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

표 44. RowsCount 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	행 수가 반환되는 워크시트의 이름입니다.	데이터 입력	문자열
돌아가기	행 수를 반환합니다.	데이터 출력	정수

매크로 실행

Excel 파일에 있는 기존 매크로를 실행합니다. 메서드에는 사용자가 실행하려는 매크로의 이름이 필요합니다.

표 45. RunMacro 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
매크로 이름	실행할 매크로의 이름입니다.	데이터 입력	문자열
돌아가기	매크로가 성공적으로 실행되었는지 여부를 나타내는 부울 값을 반환합니다.	데이터 출력	부울

크기 조정

Excel 애플리케이션 창의 너비와 높이 크기를 변경합니다. Excel 애플리케이션의 레이아웃과 모양은 특정 표시 요구 사항을 수용하도록 사용자 정의할 수 있습니다.

표 46. RowsCount 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
왼쪽	이 매개변수는 화면의 왼쪽 가장자리를 기준으로 Excel 응용 프로그램 창의 왼쪽 상단 모서리의 가로 위치를 지정합니다. 화면의 왼쪽 가장자리에서 Excel 창의 왼쪽 가장자리까지의 거리를 픽셀 또는 포인트 단위로 정의합니다.	데이터 입력	정수
상위	이 매개변수는 화면의 상단 가장자리를 기준으로 Excel 애플리케이션 창의 왼쪽 상단 모서리의 세로 위치를 나타냅니다. 화면 상단 가장자리에서 Excel 창의 상단 가장자리까지의 거리를 픽셀 또는 포인트 단위로 정의합니다.	데이터 입력	정수
너비	이 매개변수는 Excel 애플리케이션 창의 너비를 픽셀 또는 포인트 단위로 지정합니다. 왼쪽 가장자리에서 오른쪽 가장자리로 확장되는 창의 수평 크기를 결정합니다.	데이터 입력	정수
높이	이 매개변수는 Excel 애플리케이션 창의 높이를 픽셀 또는 포인트 단위로 나타냅니다. 위쪽 가장자리에서 아래쪽 가장자리까지 확장되는 창의 세로 크기를 정의합니다.	데이터 입력	정수

필터 제거

SheetName 매개변수에 지정된 워크시트에서 필터를 제거합니다.

표 47. RemoveFilter 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	메서드가 필터를 제거하는 워크시트의 이름입니다.	데이터 입력	문자열

저장

문서 내의 Microsoft Excel 데이터 또는 서식에 대한 업데이트, 변경, 추가 또는 삭제를 저장하여 작업이 보존되고 Excel 파일에 최신 업데이트가 반영되도록 합니다.

다음으로 저장

Excel 파일을 파일 경로 매개변수에 제공된 파일 경로에 다른 이름이나 형식으로 저장합니다. Password 매개변수에 값을 제공하여 파일을 암호로 보호할 수도 있습니다.

표 48. SaveAs 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
파일 경로	Excel 파일이 다른 이름이나 형식으로 저장되는 파일 경로입니다.	데이터 입력	문자열
암호	저장될 Excel 파일을 보호하는 암호입니다. 이 매개변수는 선택 사항이며 기본값은 빈 문자열입니다.	데이터 입력	문자열

복사본을 다음으로 저장

저장된 복사본의 대상 역할을 하는 지정된 경로에 Excel 파일의 복사본을 저장합니다.

표 49. SaveCopyAs 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
파일 경로	Excel 파일이 다른 이름이나 형식으로 저장되는 파일 경로입니다.	데이터 입력	문자열
암호	저장된 Excel 파일을 보호하는 암호입니다. 이 매개변수는 선택 사항이며 기본값은 빈 문자열입니다.	데이터 입력	문자열

범위 선택

Excel 워크시트 내의 셀 범위를 지정하고 강조 표시합니다.

표 50. SelectRange 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	데이터 입력	문자열
셀 범위	지정된 워크시트 내에서 선택된 셀의 범위입니다. 일반적으로 시작 및 종료 셀 참조로 식별되며 강조 표시되거나 활성화될 셀 그룹을 정의합니다.	데이터 입력	문자열

SelectRowByIndex

워크시트의 RowNumber 매개변수에 제공된 인덱스를 기반으로 전체 행을 선택합니다.

표 51. SelectRowByIndex 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	행이 선택된 워크시트의 이름입니다.	데이터 입력	문자열
행번호	선택할 행의 인덱스입니다.	데이터 입력	정수

SetActiveWorksheet

시트 이름에 지정된 워크시트를 활성 워크시트로 표시합니다.

표 52. SetActiveWorksheet 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	활성으로 설정해야 하는 워크시트의 이름입니다.	데이터 입력	문자열
돌아가기	제공된 시트가 활성으로 설정되었는지 여부를 나타내는 부울 값을 반환합니다.	데이터 출력	부울

정렬 설정

CellRange에 제공된 셀의 정렬 설정을 조정하여 Excel 워크시트 내에서 데이터의 표시 및 모양을 제어하고 스프레드시트 데이터의 시각적 표현과 가독성을 향상시켜 데이터 표시 및 통신을 개선합니다.

표 53. SetAlignment 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	데이터 입력	문자열
셀 범위	정렬 설정 또는 속성이 적용되는 셀의 범위입니다.	데이터 입력	문자열
HorizantalAlignment	지정된 범위 내에서 셀 내용의 수평 맞춤입니다. 텍스트 또는 숫자와 같은 콘텐츠가 각 셀 내에서 가로로 배치되는 방식을 결정합니다. 가능한 값으로는 왼쪽, 중앙, 오른쪽, 맞춤 또는 분산이 있습니다.	데이터 입력	HorizantalAlignment
세로 맞춤	지정된 범위 내에서 셀 콘텐츠를 세로 맞춤합니다. 콘텐츠가 각 셀 내에 수직으로 배치되는 방식을 결정합니다. 가능한 값에는 상단, 중간, 하단 또는 맞춤이 포함됩니다.	데이터 입력	세로 맞춤

SetCellColor

워크시트의 CellName 매개변수에 지정된 특정 셀의 색상 매개변수에 지정된 색상을 설정합니다.

표 54. SetCellColor 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	셀이 있는 워크시트의 이름입니다.	데이터 입력	문자열
셀 이름	색상이 설정될 셀의 이름 또는 참조를 나타냅니다.	데이터 입력	문자열
색상	셀에 적용할 RGB 색상 값을 지정합니다.	데이터 입력	ExcelRgbColor
돌아가기	수식이 제공된 특정 셀에 대해 설정되어 있는지 여부를 나타내는 부울 값을 반환합니다.	데이터 출력	부울

SetCell수식

Excel 파일의 지정된 셀에 수식을 할당합니다. 이 메서드를 사용하려면 SheetName, CellName 및 수식 매개변수를 사용하여 각각 설정할 워크시트, 셀 및 수식을 결정해야 합니다.

표 55. SetCellFormula 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	작업이 수행될 워크시트의 이름입니다.	데이터 입력	문자열
셀 이름	작업이 수행될 워크시트 내의 셀입니다.	데이터 입력	문자열
수식	지정된 셀에 적용할 수학적 또는 논리적 표현식입니다.	데이터 입력	문자열
돌아가기	지정된 셀에 대해 수식이 설정되었는지 여부를 나타내는 부울 값을 반환합니다.	데이터 출력	부울

셀값 설정

워크시트의 특정 셀에 값을 할당하여 해당 셀의 기존 콘텐츠를 대체합니다.

표 56. SetCellValue 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	데이터 입력	문자열
셀 이름	이 매개변수는 지정된 워크시트 내에서 대상 셀의 참조 또는 식별자를 나타냅니다. 셀 주소(예: "A1", "B2", "C3")로 나타낼 수 있습니다.	데이터 입력	문자열
값	숫자, 텍스트, 날짜, 수식 또는 논리 값을 포함하여 Excel에서 지원하는 모든 데이터 형식이 될 수 있는 지정된 셀에 할당할 값입니다.	데이터 입력	문자열

셀값 설정

지정된 시트 내의 메서드 편집기 대화 상자에서 구성된 대로 여러 셀의 값을 설정합니다.

표 57. SetCellValues 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	셀 값이 설정될 워크시트의 이름입니다.	데이터 입력	문자열

SetCellValuesIfRowHas

지정된 행 인덱스에서 지정된 열 이름을 검사하여 지정된 시트에서 제공된 텍스트를 스캔합니다. 텍스트가 발견되면 제공된 값을 사용하여 지정된 셀의 값을 설정합니다. 값이 성공적으로 설정된 경우 예를 반환하고, 그렇지 않으면 아니오를 반환합니다.

표 58. SetCellValuesIfRowHas 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	검색할 워크시트의 이름입니다.	데이터 입력	문자열
SearchText	지정된 열 내에서 검색할 텍스트입니다.	데이터 입력	문자열
검색 열	검색이 수행되는 열입니다. ColumnName은 A에서 AZ까지의 Excel 열을 나타내는 Enum 데이터 형식입니다.	데이터 입력	열 이름
StartRowIndex	검색이 시작되는 행 인덱스입니다.	데이터 입력	정수
돌아가기	지정된 열에서 SearchText가 발견되면 예를 반환합니다. 그렇지 않으면 False를 반환합니다.	데이터 출력	부울

SetColumnType

워크시트 내에 있는 지정된 열의 데이터 유형을 수정합니다. 예를 들어 사용자는 숫자 값이 포함된 열을 텍스트 형식으로 변환하거나 텍스트 데이터의 열을 숫자 형식으로 변경할 수 있습니다. 분석 또는 보고 요구 사항에 더 적합하도록 데이터 형식을 조정하여 데이터 표현의 일관성과 정확성을 보장할 수 있습니다. Excel에서 데이터 변환, 서식 지정, 조작과 같은 작업에 유용합니다.

표 59. SetColumnType 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	데이터 입력	문자열
형식 유형	열이 변환되는 원하는 형식 유형입니다. 이 매개변수는 열 내의 데이터가 해석되거나 표시되는 방식을 결정합니다. 가능한 값에는 숫자, 텍스트, 날짜, 시간, 통화, 백분율 또는 사용자 지정 형식이 포함될 수 있습니다.	데이터 입력	문자열
열	데이터 유형이 변경되는 지정된 워크시트의 열 참조 또는 식별자입니다. 열 문자(예: 'A', 'B', 'C')로 나타낼 수 있습니다.	데이터 입력	문자열
돌아가기	열 유형이 설정되었는지 여부를 식별하는 부울 값을 반환합니다.	데이터 출력	부울

SetColumnWidth

너비 매개변수에 제공된 모든 열의 너비를 설정합니다.

표 60. SetColumnWidth 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	열 너비가 조정되는 워크시트의 이름입니다.	데이터 입력	문자열
너비	열이 설정되는 너비(문자)입니다. 정수 값만 허용됩니다. 10진수 값은 허용되지 않습니다.	데이터 입력	정수
돌아가기	열 유형이 설정되었는지 여부를 식별하는 부울 값을 반환합니다.	데이터 출력	부울

필터 설정

특정 열에 필터를 적용합니다. 이 메서드는 지정된 시트 이름을 기반으로 워크시트를 찾은 다음 제공된 필터 값을 적용합니다.

표 61. SetFilter 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	열이 있는 워크시트의 이름입니다.	데이터 입력	문자열
열 이름	필터가 적용되는 열입니다. ColumnName은 A에서 AZ까지의 Excel 열을 나타내는 Enum 데이터 형식입니다.	데이터 입력	열 이름
필터 값	식별된 열 내에서 필터링할 값입니다.	데이터 입력	문자열

SetFilterByRow

지정된 행 번호부터 시작하여 지정된 열에 필터를 적용합니다. 이 메서드는 지정된 시트 이름을 기반으로 워크시트를 찾은 다음 제공된 필터 값을 적용합니다.

표 62. SetFilterByRow 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	데이터 입력	문자열
행번호	필터링 기준이 정의된 지정된 워크시트 내의 행 번호를 나타냅니다. 데이터를 필터링하는 데 사용할 기준이 포함된 행을 식별합니다.	데이터 입력	정수
열 이름	필터링을 수행할 기준이 되는 열의 이름 또는 식별자입니다. 필터링 기준이 적용되는 열을 나타냅니다. ColumnName은 A에서 AZ까지의 Excel 열을 나타내는 Enum 데이터 형식입니다. 제공된 ColumnName은 데이터의 시작 열을 기준으로 한 열 이름을 참조합니다. 예를 들어 데이터가 Excel 시트의 B 열에서 시작하는 경우 상대 열 인덱스 A는 B 열에 해당하고 상대 열 인덱스 B는 C 열에 해당하는 식입니다.	데이터 입력	열 이름
필터 값	필터 기준으로 사용되는 값 또는 조건입니다. 필터가 적용된 후 표시되기 위해 지정된 열의 데이터가 일치해야 하는 특정 값을 나타냅니다.	데이터 입력	문자열

SetFontStyle

Color, FontStyle, FontName, Bold 및 Underline과 같은 매개변수를 설정하여 지정된 범위 내에서 셀의 서식을 지정합니다.

표 63. SetFontStyle 메서드 매개 변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	글꼴 스타일이 설정될 워크시트의 이름입니다.	데이터 입력	문자열
셀 범위	글꼴 스타일이 설정될 셀의 범위입니다.	데이터 입력	문자열
색상	글꼴의 RGB 색상 값을 지정합니다.	데이터 입력	ExcelRgbColor
글꼴 크기	글꼴 크기를 지정합니다. 기본값은 11입니다.	데이터 입력	정수
글꼴 이름	글꼴의 이름을 지정합니다. 기본값은 Calibri입니다.	데이터 입력	문자열
굵게	글꼴을 굵게 표시해야 하는지 여부를 나타냅니다. 기본값은 False입니다.	데이터 입력	부울
밑줄	글꼴의 밑줄 스타일을 지정합니다. 기본값은 없음입니다.	데이터 입력	밑줄

SetRowHeight

Excel 워크시트 내의 특정 행의 높이를 수정합니다.

표 64. SetRowHeight 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	행이 있는 워크시트의 이름입니다.	데이터 입력	문자열
높이	원하는 높이를 지정합니다.	데이터 입력	정수
StartIndex	시작 행 인덱스입니다.	데이터 입력	문자열
EndIndex	끝 행 인덱스입니다.	데이터 입력	문자열
돌아가기	행 높이가 성공적으로 설정되었는지 여부를 나타내는 부울 값을 반환합니다.	데이터 출력	부울

SetRowValues

Excel 스프레드시트의 특정 행에 대한 값을 설정합니다. 기본적으로 RowIndex 매개변수가 -1로 설정되면 함수는 스프레드시트의 끝에 값을 삽입합니다. 즉, 특정 행 인덱스를 지정하지 않으면 스프레드시트에 있는 기존 데이터의 맨 아래에 값이 추가됩니다.

표 65. SetRowValues 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	데이터 입력	문자열
행번호	값이 설정되거나 업데이트될 행 번호를 나타냅니다. Excel에서 행은 1부터 시작하여 위에서 아래로 순차적으로 번호가 매겨집니다. RowNumber를 지정하면 값을 배치해야 하는 특정 행을 나타냅니다. -1이 RowNumber로 전달되면 일반적으로 스프레드시트 끝에 값이 삽입됨을 나타냅니다.	데이터 입력	정수

정렬

지정된 셀 범위 내의 데이터를 오름차순 또는 내림차순으로 구성합니다.

표 66. 정렬 방법 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	데이터를 정렬할 워크시트의 이름입니다.	데이터 입력	문자열
셀 범위	정렬할 데이터가 포함된 셀의 범위입니다.	데이터 입력	문자열
열 이름	데이터를 정렬할 열 이름입니다. ColumnName은 A에서 AZ까지의 Excel 열을 나타내는 Enum 데이터 형식입니다.	데이터 입력	열 이름
정렬 순서	데이터의 정렬 순서(오름차순 또는 내림차순)입니다.	데이터 입력	정렬 순서

VLook업

지정된 셀 범위의 첫 번째 열에서 특정 값을 검색한 다음 같은 행 내에 지정한 열에서 해당 값을 반환합니다.

표 67. VLookUp 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	검색할 워크시트의 이름입니다.	데이터 입력	문자열
SearchText	지정된 열 내에서 검색할 텍스트입니다.	데이터 입력	문자열
조회 범위	텍스트를 스캔할 범위입니다.	데이터 입력	문자열
근사치(ApproximateMatch)	정확히 일치하는지 또는 대략적인 일치를 원하는지 여부를 지정하는 논리적 값입니다.	데이터 입력	부울
돌아가기	매크로가 성공적으로 실행되었는지 여부를 나타내는 부울 값을 반환합니다.	데이터 출력	부울

줄 바꿈 텍스트

Excel 워크시트의 지정된 행에 있는 모든 셀에 대해 텍스트 줄 바꿈을 사용하도록 설정합니다. 텍스트 줄 바꿈을 사용하면 긴 텍스트 문자열이 셀 경계 내에 표시되고 줄 바꿈된 텍스트에 맞게 행 높이가 자동으로 조정됩니다. WrapText 메서드를 사용하면 사용자는 셀의 원래 너비를 넘어 확장되더라도 각 셀 내에서 모든 텍스트가 완전히 표시되도록 하여 데이터의 가독성을 향상시킬 수 있습니다. 이는 스프레드시트 셀 내에 긴 텍스트 항목이나 여러 줄 콘텐츠를 표시할 때 특히 유용할 수 있습니다.

표 68. WrapText 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	소스 데이터를 포함하는 워크시트의 이름입니다.	데이터 입력	문자열
행번호	해당 행의 모든 셀에 대해 텍스트 줄 바꿈이 설정된 지정된 워크시트 내의 행 번호입니다.	데이터 입력	정수

WriteToRange

데이터 매개변수에 제공된 데이터 테이블을 CellName 매개변수에 제공된 셀에서 시작하는 워크시트에 씁니다. IncludeHeaders 매개변수를 설정하여 헤더를 포함할 수도 있습니다.

표 69. WriteToRange 메서드 매개변수

매개변수	설명	데이터 포트 유형	데이터 유형
시트 이름	데이터가 기록되는 워크시트의 이름입니다.	데이터 입력	문자열
셀 이름	데이터가 기록되는 셀의 이름입니다.	데이터 입력	문자열
데이터	기록된 데이터입니다.	데이터 입력	데이터 테이블
헤더 포함	데이터를 쓸 때 헤더를 포함할지 여부를 나타내는 부울 값입니다. 기본값은 True로 설정됩니다.	데이터 입력	부울