SqlXmlCommand 개체(SQLXML 관리되는 클래스)
다음은 SqlXmlCommand 개체의 생성자입니다.
public SqlXmlCommand(string cnString)
여기서 cnString은 서버, 데이터베이스 및 로그인 정보를 식별하는 ADO 또는 OLEDB 연결 문자열입니다(예: Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI").
연결 문자열에서 Provider는 SQLOLEDB여야 하고 Data Provider는 공급자 문자열에 포함되면 안 됩니다.
작업 예제의 경우 SQL 쿼리 실행(SQLXML 관리되는 클래스)를 참조하십시오.
메서드
SqlXmlCommand 개체는 명령을 실행하는 데 다음과 같은 메서드를 포함하여 몇 가지 메서드를 지원합니다.
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 개체를 만듭니다. 이 개체의 Name 및 Value 매개 변수 값을 설정할 수 있습니다. 이 메서드는 명령에 매개 변수를 전달하려는 경우에 유용합니다. 작업 예제의 경우 SQL 쿼리 실행(SQLXML 관리되는 클래스)을 참조하십시오.void ClearParameters()
지정된 명령 개체에 대해 만든 매개 변수를 지웁니다. 이 메서드는 동일한 명령 개체에 여러 개의 쿼리를 실행하려는 경우에 유용합니다.
속성
SqlXmlCommand 개체는 다음과 같은 속성도 지원합니다.
ClientSideXml
True로 설정할 경우 행 집합과 XML 사이의 변환을 서버 대신 클라이언트에서 수행하도록 지정합니다. 이 속성은 성능 부하를 중간 계층으로 이동하려는 경우에 유용합니다. 이 속성을 사용하면 기존의 저장 프로시저를 FOR XML에 래핑하여 XML 출력을 얻을 수도 있습니다.SchemaPath
디렉터리 경로를 포함한 매핑 스키마의 이름입니다(예: C:\x\y\MySchema.xml). 이 속성은 XPath 쿼리의 매핑 스키마를 지정할 때 유용합니다. 이 속성에는 절대 경로 또는 상대 경로를 지정할 수 있으며 상대 경로를 지정할 경우 Base Path에 지정된 기본 경로를 사용하여 상대 경로가 확인됩니다. 기본 경로가 지정되어 있지 않으면 상대 경로는 현재 디렉터리에 상대적입니다. 작업 예제의 경우 .NET 환경에서 SQLXML 기능 액세스을 참조하십시오.XslPath
디렉터리 경로를 포함한 XSL 파일의 이름입니다. 이 속성에는 절대 경로 또는 상대 경로를 지정할 수 있으며 상대 경로를 지정할 경우 Base Path에 지정된 기본 경로를 사용하여 상대 경로가 확인됩니다. 기본 경로가 지정되어 있지 않으면 상대 경로는 현재 디렉터리에 상대적입니다. 작업 예제의 경우 XSL 변환 적용(SQLXML 관리되는 클래스)을 참조하십시오.Base Path
기본 경로(디렉터리 경로)입니다. 이 속성은 XSL 파일의 상대 경로(XslPath 속성을 사용하여 지정), 매핑 스키마 파일의 상대 경로(SchemaPath 속성을 사용하여 지정) 또는 XML 템플릿에 포함된 외부 스키마 참조의 상대 경로(mapping-schema 특성을 사용하여 지정)를 확인하는 데 유용합니다.OutputEncoding
명령을 실행하여 반환되는 스트림의 인코딩을 지정합니다. 이 속성은 반환되는 스트림에 특정 인코딩을 사용하려는 경우에 유용합니다. 일반적으로 UTF-8, ANSI 및 유니코드와 같은 인코딩이 사용되며 기본 인코딩은 UTF-8입니다.Namespaces
네임스페이스를 사용하는 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 기능 액세스을 참조하십시오.값
설명
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을 실행합니다.