데이터 처리 확장 프로그램에 대한 Command 클래스 구현Implementing a Command Class for a Data Processing Extension

Command 개체는 요청을 작성하고 이를 데이터 원본에 전달합니다.The Command object formulates a request and passes it on to the data source. 명령 텍스트는 텍스트 및 XML을 비롯하여 다양한 구문 형식을 취할 수 있습니다.The command text can take many different syntactical forms, including text and XML. 결과가 반환될 경우 Command 개체는 DataReader 개체 형태로 결과를 반환합니다.If results are returned, the Command object returns results as a DataReader object.

Command 클래스를 만들려면 IDbCommand를 구현합니다.To create a Command class, implement IDbCommand. ExecuteReader 메서드를 구현하여 결과 집합을 DataReader 개체 형태로 반환합니다.Implement the ExecuteReader method to return a result set as a DataReader object. Command 클래스의 ExecuteReader 메서드에는 CommandBehavior 열거를 인수로 사용하는 구현이 포함되어야 합니다.The ExecuteReader method of your Command class should include an implementation that takes a CommandBehavior enumeration as an argument. 데이터 처리 확장 프로그램을 보고서 디자이너에 배포할 경우 SchemaOnly 메서드에서 ExecuteReader 사례를 처리하는 구현을 제공합니다.If you deploy your data processing extension to Report Designer, provide an implementation that handles a SchemaOnly case in the ExecuteReader method. 스키마 전용 구현은 보고서 디자이너에 필드 목록을 제공하는 데 사용됩니다.A schema-only implementation is used to supply Report Designer with a fields list. ExecuteReader 메서드를 통해 반환된 DataReader 개체에는 결과 집합에서 필드 또는 열에 대한 유형 및 이름 정보가 포함되어야 합니다.The DataReader object returned by the ExecuteReader method needs to contain type and name information for the fields, or columns, in your result set.

선택적으로 Command 클래스는 IDbCommandAnalysis를 구현할 수 있습니다.Optionally, your Command class can implement IDbCommandAnalysis. 이 인터페이스를 통해 구현 클래스에서 쿼리를 분석하고 쿼리의 매개 변수 목록을 반환할 수 있습니다.This interface enables an implementing class to analyze a query and return a list of parameters in the query. IDbCommandAnalysis 인터페이스의 기능은 보고서 디자이너에서만 사용됩니다.The functionality of the IDbCommandAnalysis interface is only used in Report Designer. IDbCommandAnalysis를 구현하면 보고서가 미리 보기 모드에서 실행될 때마다 보고서 디자이너 사용자로 하여금 매개 변수를 결정하도록 할 수 있습니다.When you implement IDbCommandAnalysis, you enable users of Report Designer to be prompted for parameters whenever a report is run in preview mode. 또한 데이터 집합 대화 상자의 매개 변수 탭에서 매개 변수를 볼 수 있습니다.In addition, you can view the parameters in the Parameters tab of the Data Set dialog.

참고

사용자 지정 데이터 처리 확장 프로그램에서 매개 변수를 지원하지 않는 경우 IDbCommandAnalysis를 구현하면 안 됩니다.You should not implement IDbCommandAnalysis if your custom data processing extension does not support parameters.

예제 Command 클래스 구현은 SQL Server Reporting Services 제품 예제를 참조하세요.For a sample Command class implementation, see SQL Server Reporting Services Product Samples.

관련 항목:See Also

Reporting Services 확장 프로그램 Reporting Services Extensions
데이터 처리 확장 프로그램 구현 Implementing a Data Processing Extension
Reporting Services 확장 라이브러리Reporting Services Extension Library