IronWord 방법 이미지 추가 How to Add Image to DOCX in C# 아흐마드 소하일 업데이트됨:1월 31, 2026 다운로드 IronWord NuGet 다운로드 무료 체험 시작하기 LLM용 사본 LLM용 사본 LLM용 마크다운 형식으로 페이지를 복사하세요 ChatGPT에서 열기 ChatGPT에 이 페이지에 대해 문의하세요 제미니에서 열기 제미니에게 이 페이지에 대해 문의하세요 Grok에서 열기 Grok에게 이 페이지에 대해 문의하세요 혼란 속에서 열기 Perplexity에게 이 페이지에 대해 문의하세요 공유하다 페이스북에 공유하기 트위터에 공유하기 LinkedIn에 공유하기 URL 복사 이메일로 기사 보내기 This article was translated from English: Does it need improvement? Translated View the article in English IronWord는 너비, 높이 및 텍스트 감싸기와 같은 사용자 정의 가능한 속성을 사용하여 DOCX 파일에 이미지를 삽입하기 위한 ImageContent 클래스를 제공합니다. IronWord 사용하여 Word 문서에 이미지를 추가하면 문서 자동화 및 보고서 생성이 가능해집니다. 빠른 시작: C#에서 DOCX에 이미지 추가 NuGet 패키지 관리자를 통해 IronWord 설치합니다. 새 WordDocument 인스턴스를 생성하세요. ImageContent 클래스를 사용하여 이미지를 로드하세요. AddImage()를 사용하여 문서에 이미지를 추가하세요. 문서를 DOCX 형식으로 저장하세요. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/IronWord 설치하기 PM > Install-Package IronWord 다음 코드 조각을 복사하여 실행하세요. using IronWord; using IronWord.Models; // Create new document WordDocument doc = new WordDocument(); // Add image ImageContent image = new ImageContent("photo.jpg"); doc.AddImage(image); // Save document doc.SaveAs("document-with-image.docx"); 실제 운영 환경에서 테스트할 수 있도록 배포하세요. 무료 체험판으로 오늘 프로젝트에서 IronWord 사용 시작하기 Free 30 Day Trial IronWord 사용해 보세요. ## DOCX 파일에 이미지를 추가하는 방법 IronWord 의 최신 안정 버전을 다운로드하세요. 새 Word 문서를 초기화합니다. 이미지 객체(.bmp, .jpg, .png 또는 기타 지원되는 형식)를 정의하십시오. 이미지를 문서에 추가하세요 문서 파일을 저장하고 내보내세요. DOCX 파일에 이미지를 추가하는 방법은 무엇인가요? 이미지 파일 경로를 사용하여 이미지를 참조하세요. 먼저, 파일 경로를 문자열로 사용하여 ImageContent 클래스를 인스턴스화합니다. 파일 전반에 걸쳐 image 변수를 사용하여 너비 및 높이와 같은 속성을 수정합니다. 이미지를 .docx 파일에 AddImage() 기능을 사용하여 추가합니다. 문서를 내보내고 로컬에 저장하세요. 아래 예시는 부모 노드 없이 문서에 이미지를 추가합니다. 지원되는 파일 형식에는 .jpg, .png, .bmp, .tiff 및 .gif가 있습니다. 이러한 유연성 덕분에 일반적인 이미지 형식이라면 무엇이든 사용할 수 있습니다. 팁문서 계층 구조를 개선하기 위해 이미지를 단락 내의 하위 요소로 삽입합니다. 이 단락에서는 텍스트 줄 바꿈 및 기타 텍스트 서식 속성을 정의합니다. 이 접근 방식은 이미지 위치를 더 세밀하게 제어할 수 있도록 해주며, 이미지가 주변 텍스트와 자연스럽게 어우러지도록 합니다. :path=/static-assets/word/content-code-examples/how-to/add-image-insert-image.cs using IronWord; using IronWord.Models; using IronWord.Models.Enums; // initializing docx file WordDocument doc = new IronWord.WordDocument(); // instantiating image file IronWord.Models.ImageContent image = new IronWord.Models.ImageContent("sample-image.jpg"); // modifying image properties image.Width = 200; image.Height = 200; // AddImage function saving the image doc.AddImage(image); // Save and export the file doc.SaveAs("inserted-image.docx"); $vbLabelText $csharpLabel 지원되는 이미지 형식은 무엇입니까? 지원되는 파일 형식: .jpg, .png, .bmp, .tiff, .gif. 각 형식은 삽입 시에도 품질을 유지합니다. JPEG는 사진에 가장 적합합니다. PNG는 로고 및 그래픽에 투명도를 지원합니다. BMP는 압축되지 않은 고품질 영상을 제공합니다. TIFF는 고품질 인쇄 문서에 적합합니다. GIF는 간단한 애니메이션을 제공합니다(정적 문서에서는 첫 번째 프레임만 표시됩니다). 이미지는 문서의 어느 위치에 배치되어 있습니까? 이미지는 기본적으로 현재 커서 위치에 부모 노드 없이 추가됩니다. 정확한 위치 지정을 위해 이미지를 단락 내의 하위 요소로 삽입하세요. 이렇게 하면 텍스트 흐름을 더 효과적으로 제어하고 이미지를 문서 구조에 통합할 수 있습니다. ImageContent 클래스를 사용하는 이유는 무엇일까요? ImageContent 클래스는 이미지 속성을 구조화된 방식으로 관리합니다. 삽입하기 전에 크기, 위치 및 서식을 수정하십시오. 이러한 접근 방식은 문서 생성 프로세스 전반에 걸쳐 일관성을 보장하고 애플리케이션 전체에 표준 서식 규칙을 적용합니다. 이 클래스는 이미지 관련 속성을 모두 캡슐화하여 코드 유지 관리성을 높이고 서식 오류를 줄입니다. 스트림을 통해 이미지를 추가하는 방법은 무엇인가요? 로컬 이미지나 정적 URL 이미지는 이전 방법을 사용하면 쉽게 추가할 수 있습니다. 하지만 애플리케이션은 종종 데이터베이스, 웹 서비스 또는 동적으로 생성된 콘텐츠의 이미지를 사용합니다. 인증이 필요한 보안 API 뒤에 이미지를 추가하려면 Stream 메소드를 사용하세요. 아래 예시는 HTTP 클라이언트가 인증된 이미지 스트림을 가져오기 위해 인증 토큰을 전송하는 방법을 보여줍니다. 해당 스트림은 내보내기 전에 문서에 직접 통합됩니다. 이 접근 방식은 임시 파일 저장을 없애고 민감한 이미지 데이터의 보안을 강화합니다. :path=/static-assets/word/content-code-examples/how-to/add-image-insert-image-via-http-stream.cs using IronWord; using IronWord.Models; using IronWord.Models.Enums; using System.IO; using System.Net.Http; using System.Threading.Tasks; // initializing docx file WordDocument doc = new IronWord.WordDocument(); using (HttpClient client = new HttpClient()) { // Add authentication headers client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY_HERE"); client.DefaultRequestHeaders.Add("User-Agent", "MyApp/1.0"); // Get image from authenticated endpoint Stream authenticatedStream = await client.GetStreamAsync("https://api.example.com/secure/image.png"); doc.AddImage(authenticatedStream); } // Export docx doc.SaveAs("added-image-via-http-stream.docx"); $vbLabelText $csharpLabel 스트림 메서드는 언제 사용해야 할까요? Stream 메소드를 사용할 때: 이미지는 인증이 필요한 보안 API 뒤에 있습니다. 메모리에서 이미지를 동적으로 처리합니다 데이터베이스에 바이너리 데이터로 저장된 이미지 작업 이 방법은 이미지가 문서 관리 시스템, 클라우드 스토리지에 저장되거나 이미지 처리 서비스를 통해 생성되는 기업용 애플리케이션에서 효과적입니다. 스트림 로딩의 장점은 무엇인가요? 스트림 로딩은 임시 파일을 저장하지 않고 인증된 엔드포인트에서 이미지를 통합합니다. 이렇게 하면 보안과 성능이 향상됩니다. 혜택은 다음과 같습니다: 디스크 I/O 작업량 감소 디스크에 민감한 이미지 캐싱 없음 실시간 이미지 처리 워크플로우 대용량 이미지 처리를 위한 향상된 메모리 관리 기능 다양한 이미지 소스 옵션 이미지 속성을 어떻게 수정할 수 있나요? IronWord 이미지 속성을 사용자 지정할 수 있는 포괄적인 방법을 제공합니다. 문서에 이미지를 추가하기 전이나 후에 이러한 속성을 조정하십시오. 설정 설명 예 너비 이미지의 가로 크기(픽셀) `image.너비 = 500;` 키 이미지의 세로 크기(픽셀) `image.키 = 300;` wrapText 이미지 주변의 텍스트 줄 바꿈 동작 `image.wrapText = wrapText.Square;` 왼쪽에서 거리 왼쪽 가장자리에서부터의 간격 측정값(픽셀 단위) `image.왼쪽에서 거리 = 10;` 오른쪽으로부터의 거리 오른쪽 가장자리에서부터의 간격 측정값(픽셀 단위) `image.오른쪽으로부터의 거리 = 10;` 정상으로부터의 거리 상단 가장자리에서 픽셀 단위로 측정한 간격 `image.정상으로부터의 거리 = 15;` 바닥으로부터의 거리 하단 가장자리에서 픽셀 단위로 측정한 간격 `image.바닥으로부터의 거리 = 15;` 위치 공간 배치 정보(X 및 Y 좌표) `image.위치 = new Element위치(50, 100);` 규모 X축과 Y축에 대한 비례 크기 조정 요소 `image.규모 = new PointF(1.5f, 1.5f);` 번역하다 위치 재조정을 위한 변위 좌표 `image.번역하다 = new PointF(20, 30);` 너비와 높이를 어떻게 사용자 지정하나요? 화면 비율을 변경하여 사용자 지정 너비와 높이를 구현할 수 있습니다. 문서에서 이미지가 표시되는 방식을 제어하여 비율을 유지하거나 특정 레이아웃 제약 조건에 맞출 수 있습니다. :path=/static-assets/word/content-code-examples/how-to/add-image-custom-size.cs using IronWord; // initializing docx file WordDocument doc = new IronWord.WordDocument(); // instantiating image file IronWord.Models.ImageContent image = new IronWord.Models.ImageContent("sample-image.tiff"); // modifying the aspect ratio by introducing custom width image.Width = 800; image.Height = 200; // AddImage function saving the image doc.AddImage(image); // Save and export the file doc.SaveAs("custom-size-image.docx"); $vbLabelText $csharpLabel 화면 비율은 어떻게 되나요? 사용자 지정 너비 및 높이 값은 원래의 화면 비율을 재정의합니다. 헤더, 사이드바 또는 고정 크기 컨테이너와 같은 레이아웃 요구 사항에 맞게 이미지를 늘리거나 줄입니다. 과도한 왜곡은 전문적이지 않아 보일 수 있습니다. 크기 조정 시 가로 세로 비율을 유지하려면 목표 크기를 기준으로 비례적인 치수를 계산하세요. 어떤 속성을 먼저 설정해야 할까요? 속성을 다음 순서대로 설정하십시오. 크기(가로/세로) - 이미지 레이아웃의 기본 요소 위치 지정(DistanceFrom 속성) - 간격 및 여백 제어 고급 속성(크기 조정/이동) - 세부 조정 이러한 접근 방식은 각 속성이 이전 속성을 기반으로 논리적으로 구축되도록 보장합니다. 일부 속성은 서로 상호 작용합니다. 텍스트 줄 바꿈은 거리 속성의 작동 방식에 영향을 미칩니다. 자주 묻는 질문 DOCX 파일에 C#으로 이미지를 추가하는 방법은? IronWord를 사용하면 이미지를 추가하려는 이미지 파일 경로로 ImageContent 인스턴스를 생성하고 AddImage() 메서드를 사용하여 DOCX 파일에 이미지를 추가할 수 있습니다. IronWord는 JPG, PNG, BMP, TIFF, GIF와 같은 일반 형식을 지원하여 Word 문서에 이미지를 프로그래밍 방식으로 쉽게 삽입할 수 있습니다. Word 문서에 이미지를 추가할 때 지원되는 이미지 형식은 무엇인가요? IronWord는 .jpg, .png, .bmp, .tiff, .gif 파일을 포함한 모든 주요 이미지 형식을 지원합니다. 각 형식은 삽입 시 품질을 유지하며, JPEG는 사진, PNG는 투명도가 있는 그래픽, BMP는 압축되지 않은 품질, TIFF는 고품질 인쇄 문서, GIF는 간단한 애니메이션(첫 프레임만 표시)에 적합합니다. DOCX 파일의 이미지 크기와 위치를 제어할 수 있나요? 예, IronWord의 ImageContent 클래스는 너비, 높이, 텍스트 래핑과 같은 이미지 속성을 사용자 지정할 수 있게 해줍니다. 삽입 전에 치수와 위치를 수정할 수 있어 Word 문서에서 이미지의 표시 방식에 대한 완전한 제어를 제공합니다. 더 나은 문서 구조를 위해 단락 내에 이미지를 삽입하는 방법은? IronWord는 단락 내부에서 하위 요소로 이미지를 삽입할 수 있도록 하여 더 나은 문서 계층 구조와 텍스트 래핑을 제어할 수 있습니다. 이 접근 방식은 주변 텍스트 흐름과 이미지를 통합하여 상위 노드 없이 이미지를 추가하는 것보다 더 정확한 위치 지정 옵션을 제공합니다. 프로그래밍 방식으로 Word 문서에 이미지를 추가하는 가장 빠른 방법은 무엇인가요? IronWord로 가장 빠른 방법은 WordDocument 인스턴스를 생성하고, new ImageContent('photo.jpg')로 이미지를 로드하고, doc.AddImage(image)를 호출한 다음, doc.SaveAs('document-with-image.docx')로 저장하는 것입니다. 이 간단한 네 단계 프로세스는 전체 이미지 삽입 워크플로우를 처리합니다. 아흐마드 소하일 지금 바로 엔지니어링 팀과 채팅하세요 풀스택 개발자 아흐마드는 C#, Python 및 웹 기술에 탄탄한 기반을 갖춘 풀스택 개발자입니다. 그는 확장 가능한 소프트웨어 솔루션 구축에 깊은 관심을 가지고 있으며, 실제 응용 프로그램에서 디자인과 기능이 어떻게 조화를 이루는지 탐구하는 것을 즐깁니다. Iron Software 팀에 합류하기 전, 아흐마드는 자동화 프로젝트와 API 통합 업무를 담당하며 성능 향상과 개발자 경험 개선에 주력했습니다. 그는 여가 시간에 UI/UX 아이디어를 실험하고, 오픈 소스 도구에 기여하며, 복잡한 주제를 더 쉽게 이해할 수 있도록 기술 문서를 작성하는 데 몰두하기도 합니다. 시작할 준비 되셨나요? Nuget 다운로드 35,581 | 버전: 2026.3 방금 출시되었습니다 무료 체험 시작하기 NuGet 무료 다운로드 총 다운로드 수: 35,581 라이선스 보기 아직도 스크롤하고 계신가요? 빠른 증거를 원하시나요? PM > Install-Package IronWord 샘플 실행 데이터를 워드 문서로 변환 확인. NuGet 무료 다운로드 총 다운로드 수: 35,581 라이선스 보기