프린터 배달 확장 프로그램 예제

아티클
12/15/2008

업데이트: 2005년 12월 5일

프린터 배달 예제는 Reporting Services의 배달 기능을 소개하는 예제 배달 확장 프로그램입니다. 이 예제는 간단한 프린터용 배달 확장 프로그램으로서 Microsoft .NET Framework의 System.Drawing.Printing 네임스페이스와 함께 IMAGE 렌더링 확장 프로그램을 사용하여 보고서를 프린터로 배달합니다. 이 예제는 Itanium 기반 운영 체제에서 지원되지 않습니다.

SQL Server 예제는 설치하는 동안 자동으로 설치되지 않습니다. 예제 설치 방법에 대한 지침은 예제 설치를 참조하십시오.

중요:
예제는 교육용으로만 제공되므로 프로덕션 환경에 사용하기에 적합하지 않으며 프로덕션 환경에서 테스트를 수행하지 않았습니다. Microsoft는 이러한 예제에 대한 기술 지원을 제공하지 않습니다. 시스템 관리자의 허가 없이 예제 응용 프로그램 및 어셈블리를 프로덕션 SQL Server 데이터베이스 또는 보고서 서버에 연결하거나 이러한 데이터베이스 또는 보고서 서버에서 사용해서는 안 됩니다.

예제는 교육용으로만 제공되므로 프로덕션 환경에 사용하기에 적합하지 않으며 프로덕션 환경에서 테스트를 수행하지 않았습니다. Microsoft는 이러한 예제에 대한 기술 지원을 제공하지 않습니다. 시스템 관리자의 허가 없이 예제 응용 프로그램 및 어셈블리를 프로덕션 SQL Server 데이터베이스 또는 보고서 서버에 연결하거나 이러한 데이터베이스 또는 보고서 서버에서 사용해서는 안 됩니다.

요구 사항

프린터 배달 예제를 사용하려면 Visual Studio 및 Microsoft Visual C#에 대해 잘 알고 있어야 하며 다음과 같은 시스템 요구 사항이 필요합니다.

Microsoft Visual Studio 2005
Microsoft .NET Framework 버전 2.0
Reporting Services 예제.
네트워크에서 액세스할 수 있는 보고서 서버. 예제 확장 프로그램을 사용하여 추가 데이터 처리 기능을 서버에 추가하려는 경우에 필요합니다.

위치

이 예제는 Reporting Services 예제 디렉터리의 Extension Samples\PrinterDelivery Sample 하위 디렉터리에 있습니다.

예를 들면 다음과 같습니다.

C:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Extension Samples\PrinterDelivery Sample

예제 빌드

다음 단계에 따라 예제를 빌드합니다.

강력한 이름 키 파일을 생성하지 않았다면 다음 지침에 따라 해당 키 파일을 생성합니다.

강력한 이름 키 파일을 생성하려면

Microsoft Visual Studio 2005 명령 프롬프트를 엽니다. 시작을 클릭하고 모든 프로그램, Microsoft .NET Framework SDK 2.0을 차례로 가리킨 다음 SDK 명령 프롬프트를 클릭합니다.

-- 또는--

Microsoft .NET Framework 명령 프롬프트를 엽니다. 시작을 클릭하고 모든 프로그램, Microsoft .NET Framework SDK 2.0을 차례로 가리킨 다음 SDK 명령 프롬프트를 클릭합니다.
디렉터리 변경 명령(CD)을 사용하여 명령 프롬프트 창의 현재 디렉터리를 예제가 설치된 폴더로 변경합니다.

[!참고] 예제가 있는 폴더를 확인하려면 시작 단추를 클릭하고 모든 프로그램, Microsoft SQL Server, 설명서 및 자습서를 차례로 가리킨 다음 예제 디렉터리를 클릭하십시오. 기본 설치 위치가 사용된 경우 예제는 <system_drive>:\Program Files\Microsoft SQL Server\100\Samples에 있습니다.
명령 프롬프트에서 다음 명령을 실행하여 키 파일을 생성합니다.

sn -k SampleKey.snk

중요:

강력한 이름 키 쌍에 대한 자세한 내용은 MSDN의 .NET Development Center에서 "Security Briefs: Strong Names and Security in the .NET Framework"를 참조하십시오.

중요:
강력한 이름 키 쌍에 대한 자세한 내용은 MSDN의 .NET Development Center에서 "Security Briefs: Strong Names and Security in the .NET Framework"를 참조하십시오.

.NET Framework SDK를 사용하여 예제를 컴파일하려면

보고서 서버 \bin 디렉터리의 Microsoft.ReportingServices.Interfaces.dll을 예제 폴더에 복사합니다. 기본적으로 Microsoft.ReportingServices.Interfaces.dll은 설치된 Reporting Services 인스턴스의 \Reporting Services\ReportServer\bin 하위 디렉터리에 있습니다. 정확한 경로는 사용자의 Reporting Services 설치에 따라 달라집니다. 예를 들면 다음과 같습니다.
```
C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportManager\Bin
```
다음 명령을 실행하여 예제 배달 확장 프로그램인 Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll을 만듭니다.
```
csc /t:library /out:Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll *.cs /r:Microsoft.ReportingServices.Interfaces.dll
```

Visual Studio를 사용하여 예제를 컴파일하려면

Visual Studio에서 예제 솔루션 파일(PrinterDeliveryCS.sln 또는 PrinterDeliveryVB.sln)을 엽니다.
솔루션 탐색기에서 PrinterDelivery 프로젝트를 선택합니다.
프로젝트 메뉴에서 참조 추가를 클릭합니다.

참조 추가 대화 상자가 열립니다.
.NET 탭을 클릭합니다.
찾아보기를 클릭하여 로컬 드라이브에서 Microsoft.ReportingServices.Interfaces.dll 파일을 찾습니다. 기본적으로 이 어셈블리는 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin에 있습니다. 확인을 클릭합니다.

선택한 참조가 프로젝트에 추가됩니다.
빌드 메뉴에서 솔루션 빌드를 클릭합니다.

예제 배포

위의 단계를 완료하고 나면 Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll을 보고서 서버와 보고서 관리자에 배포하여 보고서 배달에 사용할 수 있습니다.

예제를 배포하려면

Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll을 보고서 서버에 복사합니다. 보고서 서버 확장 프로그램의 기본 위치는 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin입니다.
RSReportServer.config 파일에서 <Delivery> 요소 아래에 다음 항목을 입력합니다.
```
<Extension Name="Printer Delivery Sample" Type="Microsoft.Samples.ReportingServices.PrinterDelivery.PrinterDeliveryProvider,Microsoft.Samples.ReportingServices.PrinterDeliverySample">
   <Configuration>
      <Printers>
         <Printer>\\Server\MyNetworkPrinter1</Printer>
         <Printer>\\Server\MyNetworkPrinter2</Printer>
         <Printer>MyLocalPrinter</Printer>
      </Printers>
   </Configuration>
</Extension>
```
[!참고] <Printers> 요소는 배달 확장 프로그램 Printer 설정에 고정된 프린터 이름 집합을 사용할 수 있도록 만들어져 있습니다. 최종적으로 이 목록은 배달 확장 프로그램이 설치된 보고서 서버의 사용 가능한 프린터의 알려진 목록에 대해 검사됩니다. 선택한 프린터가 보고서 서버의 설치된 프린터의 알려진 목록과 일치하지 않을 경우 "현재 {0} 프린터가 서버에 설치되어 있지 않습니다"라는 메시지가 나타나고 배달이 실패합니다. 보고서 서버에서 사용하는 Windows 서비스 계정이 Windows에 설치된 프린터로 인쇄할 권한이 없는 경우 이 프린터는 사용 가능한 프린터 목록에 포함되지 않습니다.
어셈블리를 보고서 관리자에 복사합니다. 보고서 관리자에 대한 확장 프로그램의 기본 위치는 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportManager\bin입니다.

RSWebApplication.config 파일에서 <DeliveryUI> 요소 아래에 다음 항목을 입력합니다.

<Extension Name="Printer Delivery Sample" Type="Microsoft.Samples.ReportingServices.PrinterDelivery.PrinterDeliveryUIProvider,Microsoft.Samples.ReportingServices.PrinterDeliverySample"/>

배달 확장 프로그램 배포 방법은 Deploying a Delivery Extension를 참조하십시오.

예제에 대한 코드 액세스 보안을 구성하려면

보고서 서버 정책 구성 파일(rssrvpolicy.config)을 엽니다. 이 파일의 기본 위치는 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer입니다.

배달 확장 프로그램에는 완전 신뢰 수준을 부여해야 합니다. 이렇게 하려면 <CodeGroup ?Zone="MyComputer" /> 요소 아래에 다음 코드 그룹 정보를 추가합니다.

<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="PrinterDeliveryCodeGroup"
   Description="Code group for my delivery extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll"
       />
</CodeGroup>

보고서 관리자에서 예제 프린터 배달 확장 프로그램을 사용하는 경우 보고서 관리자 정책 구성 파일(rsmgrpolicy.config) 및 다음 코드 그룹을 사용하여 1단계와 2단계를 반복합니다.

<CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="PrinterDeliveryCodeGroup"
   Description="Code group for my delivery extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportManager\bin\Microsoft.Samples.ReportingServices.PrinterDeliverySample.dll"
       />
</CodeGroup>

rsmgrpolicy.config 파일의 기본 위치는 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportManager입니다.

예제 배포를 마쳤으면 Iisreset.exe 다시 설정 도구를 사용하여 Microsoft 인터넷 정보 서비스(IIS)를 다시 설정한 후 Reporting Services Windows 서비스를 다시 시작합니다.

.NET 보안 및 Reporting Services에 대한 자세한 내용은 Understanding Code Access Security in Reporting Services를 참조하십시오.

참고 항목

작업

코드 예제 컴파일 및 실행
SQL Server Reporting Services 예제

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스	내역
2005년 12월 5일	변경된 내용 키 파일의 이름 및 위치를 포함하여 키 파일 생성 방법에 대한 정보를 변경했습니다.

다음을 통해 공유