다음을 통해 공유


XMLTask 클래스

정의

OperationType 열거형의 값인 DTSXMLOperation 속성에 따라 여러 XML 태스크를 실행하는 데 사용되는 멤버를 포함합니다. 이 클래스는 상속될 수 없습니다.

public ref class XMLTask sealed : Microsoft::SqlServer::Dts::Runtime::Task, Microsoft::SqlServer::Dts::Runtime::IDTSBreakpointSite, Microsoft::SqlServer::Dts::Runtime::IDTSComponentPersist, Microsoft::SqlServer::Dts::Tasks::XMLTask::IDTSXMLTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("BE19D629-EC49-455C-9708-27E3849F3C2A")]
public sealed class XMLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.XMLTask.IDTSXMLTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("935AC7BD-FEBE-4104-9E92-0D04136FFA27")]
public sealed class XMLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.XMLTask.IDTSXMLTask
[Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")]
[System.Runtime.InteropServices.Guid("3A8B754B-0C03-4159-88DA-E3578D25A20B")]
public sealed class XMLTask : Microsoft.SqlServer.Dts.Runtime.Task, Microsoft.SqlServer.Dts.Runtime.IDTSBreakpointSite, Microsoft.SqlServer.Dts.Runtime.IDTSComponentPersist, Microsoft.SqlServer.Dts.Tasks.XMLTask.IDTSXMLTask
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2016; © 2015 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=13.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("BE19D629-EC49-455C-9708-27E3849F3C2A")>]
type XMLTask = class
    inherit Task
    interface IDTSXMLTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2017; © 2017 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=14.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("935AC7BD-FEBE-4104-9E92-0D04136FFA27")>]
type XMLTask = class
    inherit Task
    interface IDTSXMLTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
[<Microsoft.SqlServer.Dts.Runtime.DtsTask(HelpKeyword="sql13.dts.designer.xmltask.F1", LocalizationType=typeof(Microsoft.SqlServer.Dts.Tasks.XMLTask.Localized), SamplesTag="SsisXmlTask", TaskContact="XML Task; Microsoft Corporation; SQL Server 2019; © 2019 Microsoft Corporation; All Rights Reserved;http://www.microsoft.com/sql/support/default.asp;1", TaskType="DTS90", UITypeName="Microsoft.SqlServer.XMLTaskUI.XMLTaskUI, Microsoft.SqlServer.XMLTaskUI, Version=15.0.0.0, Culture=Neutral, PublicKeyToken=89845dcd8080cc91")>]
[<System.Runtime.InteropServices.Guid("3A8B754B-0C03-4159-88DA-E3578D25A20B")>]
type XMLTask = class
    inherit Task
    interface IDTSXMLTask
    interface IDTSBreakpointSite
    interface IDTSSuspend
    interface IDTSComponentPersist
Public NotInheritable Class XMLTask
Inherits Task
Implements IDTSBreakpointSite, IDTSComponentPersist, IDTSXMLTask
상속
특성
구현

설명

자세한 내용은 XML 작업을 참조하세요.

생성자

XMLTask()

XMLTask 클래스의 새 인스턴스를 초기화합니다.

속성

DebugMode

작업에서 중단점이 활성화되어 있는지 확인해야 하는지 여부를 나타내는 부울입니다.

Destination

XML 태스크에서 작업 결과를 저장하는 대상 연결 또는 변수의 이름을 가져오거나 설정합니다.

DestinationType

XML 태스크에서 XML 문서를 저장하는 대상 유형을 나타내는 DTSXMLSaveResultTo 열거 값을 가져오거나 설정합니다.

DiffAlgorithm

OperationTypeDiff일 때 사용할 비교 알고리즘을 가져오거나 설정합니다.

DiffGramDestination

XML 태스크에서 DiffGram 문서를 저장하는 대상 연결 또는 변수의 이름을 가져오거나 설정합니다.

DiffGramDestinationType

XML 태스크에서 DiffGram 문서를 저장하는 대상 유형을 나타내는 값을 가져오거나 설정합니다.

DiffOptions

작업에서 문서를 비교할 때 사용하는 옵션을 나타내는 값을 가져오거나 설정합니다.

ExecutionValue

태스크 실행 결과를 반환합니다.

FailOnDifference

XML 문서가 유효성 검사 스키마에 따라 유효성을 검사하지 못할 경우 작업이 실패하는지 여부를 나타내는 부울을 가져오거나 설정합니다.

FailOnValidationFail

유효성 검사에 실패할 때 작업이 실패하는지 여부를 나타내는 부울을 가져오거나 설정합니다.

Namespaces

XML 태스크에 대한 네임스페이스 컬렉션을 가져오거나 설정합니다.

NodeList

XPath 작업에서 생성하는 노드 컬렉션을 포함하는 ArrayList 클래스를 가져옵니다.

OperationType

태스크에서 수행하는 유효성 검사 또는 병합과 같은 작업 유형을 나타내는 DTSXMLOperation 열거 값을 가져오거나 설정합니다.

OverwriteDestination

작업이 기존 대상 파일을 덮어쓰는지 여부를 나타내는 부울을 가져오거나 설정합니다.

PutResultInOneNode

작업이 결과를 한 노드에 배치하는지 여부를 나타내는 부울을 가져오거나 설정합니다.

SaveDiffGram

비교 결과(DiffGram 문서)가 저장되는지 여부를 나타내는 부울을 가져오거나 설정합니다.

SaveOperationResult

XML 태스크가 Diff 작업 출력을 저장하는지 여부를 나타내는 부울을 가져오거나 설정합니다.

SecondOperand

두 개의 피연산자를 사용하는 작업에서 두 번째 피연산자인 사용자 제공 텍스트, 연결 또는 변수의 이름을 가져오거나 설정합니다. 두 번째 피연산자는 작업에 따라 XML 문서, DiffGram, XSLT, XPath 또는 유효성 검사 문서일 수 있습니다.

SecondOperandType

SecondOperand에서 찾은 XML 문서, DiffGram, XSLT, XPath 또는 유효성 검사 문서를 포함하는 원본 유형을 나타내는 값을 가져오거나 설정합니다.

Source

작업에서 사용하는 원본인 사용자 제공 텍스트, 연결 또는 변수의 이름을 가져오거나 설정합니다.

SourceType

작업에서 사용하는 XML 문서를 포함하는 원본 유형을 나타내는 DTSXMLSourceType 열거형의 값을 가져오거나 설정합니다.

SuspendRequired

태스크가 중단점을 발견할 때 일시 중단해야 하는지 여부를 나타내는 부울을 가져오거나 설정합니다. 이 값은 중단점에 도달할 때 태스크 및 컨테이너의 런타임 엔진에서 설정됩니다.

TargetServerVersion

OperationType 열거형의 값인 DTSXMLOperation 속성에 따라 여러 XML 태스크를 실행하는 데 사용되는 멤버를 포함합니다. 이 클래스는 상속될 수 없습니다.

(다음에서 상속됨 Task)
ValidationDetails

OperationType 열거형의 값인 DTSXMLOperation 속성에 따라 여러 XML 태스크를 실행하는 데 사용되는 멤버를 포함합니다. 이 클래스는 상속될 수 없습니다.

ValidationType

작업에서 사용하는 유효성 검사 유형을 나타내는 DTSXMLValidationType 열거 값을 가져오거나 설정합니다.

Version

멤버가 사용되지 않습니다. 은 비고를 참조하세요. *** 태스크 버전을 반환합니다. 이 속성은 읽기 전용입니다.

(다음에서 상속됨 Task)
XPathOperation

수행할 XPath 작업을 나타내는 DTSXMLXPathOperation 열거 값을 가져오거나 설정합니다.

XPathStringSource

XPath 식의 원본을 가져오거나 설정합니다.

XPathStringSourceType

DTSXMLSourceType 속성의 XPath 식을 포함하는 원본 유형을 나타내는 XPathStringSource 열거형의 값을 가져오거나 설정합니다.

메서드

AcceptBreakpointManager(BreakpointManager)

BreakpointManager를 태스크에 전달합니다. 태스크는 중단점 관리자를 사용하여 중단점을 만들고 제거하며, 중단점 상태를 확인합니다. 이 메서드는 런타임을 통해 호출되며 코드에 사용되지 않습니다.

CanUpdate(String)

멤버가 사용되지 않습니다. 은 비고를 참조하세요. 새 패키지 XML이 이전 패키지 XML을 업데이트할 수 있는지 여부를 나타내는 부울입니다.

(다음에서 상속됨 Task)
Equals(Object)

두 개체 인스턴스가 같은지 확인합니다.

(다음에서 상속됨 DtsObject)
Execute(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging, Object)

작업을 실행합니다.

GetConnectionID(Connections, String)

연결의 ID를 포함하는 문자열을 가져옵니다.

(다음에서 상속됨 Task)
GetConnectionName(Connections, String)

연결 이름을 포함하는 String을 가져옵니다.

(다음에서 상속됨 Task)
GetHashCode()

이 인스턴스의 해시 코드를 반환합니다.

(다음에서 상속됨 DtsObject)
InitializeTask(Connections, VariableDispenser, IDTSInfoEvents, IDTSLogging, EventInfos, LogEntryInfos, ObjectReferenceTracker)

이 태스크와 연결된 속성을 초기화합니다. 이 메서드는 런타임을 통해 호출되며 코드에 사용되지 않습니다.

LoadFromXML(XmlElement, IDTSInfoEvents)

이 메서드는 애플리케이션 코드에서 호출할 수 없습니다. .xml로 저장된 패키지를 로드하려면 LoadPackage(String, IDTSEvents) 메서드를 사용합니다.

ResumeExecution()

일시 중지 이후 태스크 실행을 다시 시작합니다. 태스크 또는 컨테이너는 런타임 엔진에 의해 다시 시작됩니다.

SaveToXML(XmlDocument, IDTSInfoEvents)

이 메서드는 애플리케이션 코드에서 호출할 수 없습니다. 패키지를 .xml로 저장하려면 SaveToXml(String, Package, IDTSEvents) 메서드를 사용합니다.

SuspendExecution()

실행 파일을 일시 중지해야 함을 나타냅니다. 이 메서드는 런타임 엔진을 통해 호출됩니다.

Update(String)

멤버가 사용되지 않습니다. 은 비고를 참조하세요. 이 메서드는 true로 설정된 경우 CanUpdate(String) 이전 패키지 XML을 새 패키지 XML로 업데이트합니다.

(다음에서 상속됨 Task)
Validate(Connections, VariableDispenser, IDTSComponentEvents, IDTSLogging)

구성 요소가 제대로 구성되었는지 확인합니다.

적용 대상