다음을 통해 공유

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

  • 아티클

적용 대상: SQL Server Azure SQL Database

SqlXmlCommand 개체의 생성자입니다.

public SqlXmlCommand(string cnString)

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

연결 문자열 Provider SQLOLEDB여야 하며 Data Provider 공급자 문자열에 포함되지 않아야 합니다.

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

메서드

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

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

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 쿼리 실행을 참조 하세요.

TheSqlXmlCommand 개체는 다음과 같은 추가 메서드도 지원합니다.

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

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

속성

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

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

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

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

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

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 기능 액세스를 참조 하세요.

값 설명
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 관리되는 클래스)