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

명령 개체는 요청을 생성 하 고 데이터 원본에 전달 합니다.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. 결과 반환 되는 경우는 명령 와 결과 반환 하는 개체는 DataReader 개체입니다.If results are returned, the Command object returns results as a DataReader object.

만들려는 명령 클래스를 구현 IDbCommand합니다.To create a Command class, implement IDbCommand. 구현 된 ExecuteReader 으로 설정 된 결과 반환 하는 메서드는 DataReader 개체입니다.Implement the ExecuteReader method to return a result set as a DataReader object. 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. DataReader 에서 반환 된 개체는 ExecuteReader 열을 결과 집합에서 또는 메서드는 필드에 대 한 유형 및 이름 정보가 포함 되어야 합니다.The DataReader object returned by the ExecuteReader method needs to contain type and name information for the fields, or columns, in your result set.

필요에 따라 프로그램 명령 클래스를 구현할 수 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.

샘플 명령 클래스 구현을 참조 하십시오. 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