Attachments

이 페이지에서는 PDF 내부에 파일을 삽입하는 방법을 다룹니다. 두 가지 별개의 메커니즘이 있습니다: 문서 수준 첨부 파일은 페이지에 보이는 흔적 없이 삽입되는 파일이며, 페이지 고정 파일 첨부 주석은 특정 페이지에 클릭 가능한 아이콘을 배치합니다.

문서 수준 첨부 파일

Document.AddAttachment()은(는) bytes을(를) name 아래에 삽입하고, 문서의 embedded-file 이름 트리에 upsert합니다 — 동일한 이름으로 다시 추가하면 기존 항목이 덮어쓰기됩니다. 이는 Attachment 핸들을 반환합니다. Document.GetAttachments()는 모든 문서 수준 첨부 파일을 이름별로 정렬된 Attachment 핸들 배열로 반환하고, Document.RemoveAttachment()은 이름으로 하나를 제거합니다.

Attachment 핸들은 Name, Description, MimeType, Size, CreationDate, ModDate을(를) 속성으로 노출하고, GetBytes()은(는) 삽입된 파일의 원시 콘텐츠를 읽어들입니다. 또한 GetField() / SetField() / RemoveField()은(는) 개별 /Filespec 필드에 대한 하위 수준 접근을 제공합니다. 선택적 AttachmentOptions가 AddAttachment()에 전달될 때 mimeType, description, compress, creationDate, modDate을(를) 허용합니다.

현재 이 플랫폼에 대한 지식 스냅샷에서는 이 API에 대한 검증된 코드 예제가 없습니다 — 정확한 메서드와 속성 이름은 아래 API Reference 요약을 참조하십시오.

페이지 고정 파일 첨부

Page.AddFileAttachment()은 파일을 삽입하고 특정 페이지의 주어진 rect에 /FileAttachment 아이콘 주석을 배치하며, FileAttachmentAnnotation을 반환합니다. 문서 수준 첨부와 달리, 이것은 PDF 뷰어에서 보이고 클릭할 수 있습니다. FileAttachmentAnnotation은 공통 주석 속성(Rect, Color, Contents, Name, Flags, Print, Hidden, Opacity)에 자체 Icon와 FileName를 추가로 가지고 있으며, GetBytes()를 지원해 삽입된 내용을 읽고 Flatten()을 지원해 아이콘을 정적 페이지 콘텐츠에 삽입합니다.

팁 및 모범 사례

PDF와 함께 이동하지만 페이지에 표시되지 않아야 하는 파일에는 문서 수준 첨부(Document.AddAttachment())를 사용하고, 파일을 특정 위치의 클릭 가능한 아이콘으로 표시해야 할 경우 Page.AddFileAttachment()을 사용하십시오.
Document.AddAttachment()은 동일한 name을 가진 기존 첨부 파일을 덮어씁니다 — 의도치 않게 교체를 피하려면 먼저 Document.GetAttachments()를 확인하십시오.
GetBytes()을 사용하여 핸들 유형에 관계없이 첨부 파일의 내용을 다시 읽을 수 있습니다 — 이 메서드는 Attachment와 FileAttachmentAnnotation 모두에 존재합니다.

일반적인 문제

문제	원인	해결 방법
새로 추가된 첨부 파일이 기존 파일을 교체했습니다	`Document.AddAttachment()`가 이미 사용 중인 `name`와 함께 호출되었습니다	이름 충돌을 확인하려면 먼저 `Document.GetAttachments()`를 호출하십시오
첨부 파일에 페이지에 표시되는 아이콘이 없습니다	`Document.AddAttachment()`가 사용되었습니다, 이는 문서 수준이며 설계상 페이지에 존재하지 않습니다	가시적이고 페이지에 고정된 아이콘을 위해 `Page.AddFileAttachment()`을(를) 사용하세요
`Document.RemoveAttachment()`은(는) `false`을(를) 반환합니다	지정된 `name`에 해당하는 첨부 파일이 이름 트리 내에 존재하지 않습니다	삭제하기 전에 `Document.GetAttachments()`을(를) 통해 정확한 이름을 확인하십시오

FAQ

Document.AddAttachment와 Page.AddFileAttachment의 차이점은 무엇입니까?

Document.AddAttachment()은(는) 문서 수준에서 파일을 삽입하지만 어떤 페이지에도 보이는 아이콘이 없습니다. Page.AddFileAttachment()은(는) 파일을 삽입하고 특정 페이지의 특정 위치에 클릭 가능한 /FileAttachment 아이콘 주석을 배치합니다.

문서에 이미 삽입된 모든 첨부 파일을 어떻게 나열합니까?

Document.GetAttachments()을(를) 호출하면, 이름별로 정렬된 Attachment 핸들의 배열 형태로 모든 문서 수준 첨부 파일을 반환합니다.

첨부 파일의 내용물을 어떻게 다시 읽어올 수 있습니까?

Attachment (또는 FileAttachmentAnnotation) 핸들에 대해 GetBytes()을(를) 호출하십시오 — 두 경우 모두 사용할 수 있습니다.

첨부 파일을 제거할 수 있습니까?

예 — Document.RemoveAttachment(name)은(는) 이름으로 문서 수준 첨부 파일을 제거하고, 해당 파일이 발견되어 제거되었는지 여부를 반환합니다.

API Reference 요약

클래스/메서드	설명
`Document.AddAttachment()`	바이트를 명명된 문서 수준 첨부 파일로 삽입합니다
`Document.GetAttachments()`	문서 수준 첨부 파일을 모두 나열합니다
`Document.RemoveAttachment()`	이름으로 문서 수준 첨부 파일을 제거합니다
`Attachment`	하나 이상의 내장 파일을 처리합니다; `Name`, `Description`, `MimeType`, `Size`, `GetBytes()`
`Page.AddFileAttachment()`	파일을 페이지에 고정된 클릭 가능한 아이콘 주석으로 삽입합니다
`FileAttachmentAnnotation`	페이지에 고정된 첨부 파일의 주석 핸들; `Icon`, `FileName`을 추가합니다

참조

Aspose.PDF — Enterprise Documentation