SQLXML 관리되는 클래스 - SqlXmlCommand 개체

  • 아티클

적용 대상: SQL Server Azure SQL 데이터베이스

SqlXmlCommand 개체의 생성자입니다.

public SqlXmlCommand(string cnString)

여기서 cnString 는 서버, 데이터베이스 및 로그인 정보를 식별하는 ADO 또는 OLEDB 연결 문자열입니다(예: Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI").

연결 문자열에서 Provider는 SQLOLEDB여야 하고 Data Provider는 공급자 문자열에 포함되면 안 됩니다.

작업 샘플은 SQL 쿼리 실행(SQLXML 관리 클래스)을 참조하세요.

메서드

TheSqlXmlCommand 개체는 명령을 실행하기 위한 다음 메서드를 포함하여 여러 메서드를 지원합니다.

void ExecuteNonQuery()
명령을 실행하지만 아무것도 반환하지 않습니다. 이 메서드는 쿼리를 사용하지 않는 명령, 즉 아무것도 반환하지 않는 명령을 실행하려는 경우에 유용합니다. 예를 들어 레코드를 업데이트하지만 아무것도 반환하지 않는 DiffGram 또는 updategram이 이러한 메서드에 속합니다.

Stream ExecuteStream()
새 Stream 개체를 반환합니다. 이 메서드는 쿼리 결과를 새 스트림에 반환하려는 경우에 유용합니다. 작업 샘플은 SQL 쿼리 실행(SQLXML 관리 클래스)을 참조하세요.

public void ExecuteToStream(Stream outputStream)
쿼리 결과를 기존 스트림에 씁니다. 이 메서드는 결과를 추가해야 하는 스트림이 있는 경우에 유용합니다(예: System.Web.HttpResponse.OutputStream에 쿼리 결과를 작성하려면). 작업 샘플은 SQL 쿼리 실행(SQLXML 관리 클래스)을 참조하세요.

XmlReader ExecuteXmlReader()
XmlReader 개체를 반환합니다. 이 메서드를 사용하여 XmlReader 개체의 데이터를 직접 조작하거나 System.Xml 연결 가능한 아키텍처를 연결할 수 있습니다. 자세한 내용은 Microsoft .NET Framework 설명서를 참조하세요. 작업 샘플은 ExecuteXMLReader 메서드를 사용하여 SQL 쿼리 실행을 참조하세요.

또한SqlXmlCommand 개체는 다음과 같은 추가 메서드를 지원합니다.

SqlXmlParameter CreateParameter()
SqlXmlParameter 개체를 만듭니다. 이 개체의 이름 및 값 매개 변수에 대한 값을 설정할 수 있습니다. 이 메서드는 명령에 매개 변수를 전달하려는 경우에 유용합니다. 작업 샘플은 SQL 쿼리 실행(SQLXML 관리 클래스)을 참조하세요.

void ClearParameters()
지정된 명령 개체에 대해 만든 매개 변수를 지웁니다. 이 메서드는 동일한 명령 개체에 여러 개의 쿼리를 실행하려는 경우에 유용합니다.

속성

SqlXmlCommand 개체는 다음 속성도 지원합니다.

ClientSideXml
True로 설정할 경우 행 집합과 XML 사이의 변환을 서버 대신 클라이언트에서 수행하도록 지정합니다. 이 속성은 성능 부하를 중간 계층으로 이동하려는 경우에 유용합니다. 이 속성을 사용하면 기존의 저장 프로시저를 FOR XML에 래핑하여 XML 출력을 얻을 수도 있습니다.

SchemaPath
디렉터리 경로를 포함한 매핑 스키마의 이름입니다(예: C:\x\y\MySchema.xml). 이 속성은 XPath 쿼리의 매핑 스키마를 지정할 때 유용합니다. 이 속성에는 절대 경로 또는 상대 경로를 지정할 수 있으며 경로가 상대 경로인 경우 기준 경로에 지정된 기본 경로는 상대 경로를 resolve 데 사용됩니다. 기본 경로가 지정되어 있지 않으면 상대 경로는 현재 디렉터리에 상대적입니다. 작업 샘플은 .NET 환경에서 SQLXML 기능 액세스를 참조하세요.

XslPath
디렉터리 경로를 포함한 XSL 파일의 이름입니다. 이 속성에는 절대 경로 또는 상대 경로를 지정할 수 있으며 경로가 상대 경로인 경우 기준 경로에 지정된 기본 경로는 상대 경로를 resolve 데 사용됩니다. 기본 경로가 지정되어 있지 않으면 상대 경로는 현재 디렉터리에 상대적입니다. 작업 샘플은 XSL 변환 적용(SQLXML 관리 클래스)을 참조하세요.

기본 경로
기본 경로(디렉터리 경로)입니다. 이 속성은 XSL 파일(XslPath 속성 사용), 매핑 스키마 파일(SchemaPath 속성 사용) 또는 XML 템플릿의 외부 스키마 참조( mapping-schema 특성을 사용하여 지정됨)에 대해 지정된 상대 경로를 확인하는 데 유용합니다.

OutputEncoding
명령을 실행하여 반환되는 스트림의 인코딩을 지정합니다. 이 속성은 반환되는 스트림에 특정 인코딩을 사용하려는 경우에 유용합니다. 일반적으로 UTF-8, ANSI 및 유니코드와 같은 인코딩이 사용되며 기본 인코딩은 UTF-8입니다.

네임스페이스
네임스페이스를 사용하는 XPath 쿼리를 실행할 수 있습니다. 네임스페이스를 사용하는 XPath 쿼리에 대한 자세한 내용은 네임 스페이스를 사용하여 XPath 쿼리 실행(SQLXML 관리 클래스)을 참조하세요. 작업 샘플은 XPath 쿼리 실행(SQLXML 관리 클래스)을 참조하세요.

RootTag
명령을 실행하여 생성된 XML의 단일 루트 요소를 제공합니다. 유효한 XML 문서에는 루트 수준의 단일 태그가 필요합니다. 명령을 실행하여 XML 조각(단일 최상위 요소가 없음)이 생성된 경우, 반환되는 XML의 루트 요소를 지정할 수 있습니다. 작업 샘플은 XSL 변환 적용(SQLXML 관리 클래스)을 참조하세요.

CommandText
명령 텍스트입니다. 이 속성은 실행할 명령의 텍스트를 지정하는 데 사용됩니다. 작업 샘플은 SQL 쿼리 실행(SQLXML 관리 클래스)을 참조하세요.

CommandStream
명령 스트림입니다. 이 속성은 파일(예: XML 템플릿)에서 명령을 실행하려는 경우에 유용합니다. CommandStream을 사용하는 경우 "Template", "UpdateGram" 및 "DiffGram" CommandType 값만 지원됩니다. 작업 샘플은 CommandStream 속성을 사용하여 템플릿 파일 실행을 참조하세요.

CommandType
명령의 형식을 식별합니다. 이 속성은 실행할 명령의 형식을 지정하는 데 사용됩니다. 명령 형식은 다음 표에 나와 있는 값에 따라 결정됩니다. 작업 샘플은 .NET 환경에서 SQLXML 기능 액세스를 참조하세요.

값 Description
SqlXmlCommandType.Sql SQL 명령(예: SELECT * FROM Employees FOR XML AUTO)을 실행합니다.
SqlXmlCommandType.XPath XPath 명령(예: Employees[@EmployeeID=1])을 실행합니다.
SqlXmlCommandType.Template XML 템플릿을 실행합니다.
SqlXmlCommandType.TemplateFile 지정된 경로에 있는 템플릿 파일을 실행합니다.
SqlXmlCommandType.UpdateGram Updategram을 실행합니다.
SqlXmlCommandType.Diffgram DiffGram을 실행합니다.

참고 항목

SqlXmlParameter 개체(SQLXML 관리되는 클래스)
SqlXmlAdapter 개체(SQLXML 관리되는 클래스)