XMLTask.Validate 메서드

정의

네임스페이스:: Microsoft.SqlServer.Dts.Tasks.XMLTask

어셈블리:: Microsoft.SqlServer.XMLTask.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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

public:
 override Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);

public override Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate(Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);

override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult

Public Overrides Function Validate (connections As Connections, variableDispenser As VariableDispenser, events As IDTSComponentEvents, log As IDTSLogging) As DTSExecResult

매개 변수

connections: Connections

작업에 사용되는 여러 가지 Connections 집합.

variableDispenser: VariableDispenser

VariableDispenser 변수를 잠그는 객체입니다.

events: IDTSComponentEvents

인터페이스를 구현하는 개체입니다 IDTSComponentEvents .

log: IDTSLogging

인터페이스를 구현하는 개체입니다 IDTSLogging .

반품

DTSExecResult

열거형의 DTSExecResult 값입니다.

예제

다음 코드 예시는 패키지의 일부로 를 XMLTask 생성합니다. 작업이 생성된 후에는 여러 속성을 설정한 후 의 메서드Package를 Validate 호출합니다.

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Tasks.XMLTask;  

namespace XMLTask_API  
{  
        class Program  
        {  
        static void Main(string[] args)  

            // Set up the objects and tasks.  
            Package pkg = new Package();  
            Executable exec1 = pkg.Executables.Add("STOCK:XMLTask");  
            TaskHost th = exec1 as TaskHost;  
            XMLTask myTask = th.InnerObject as XMLTask;  

            // Create a FILE connection manager to books.xml.  
            ConnectionManager connMgr = pkg.Connections.Add("FILE");  
            connMgr.Name = "XMLConnectionManager";  
            // The file, Books.xml, is stored on the C:\ drive.  
            connMgr.ConnectionString = @"c:\books.xml";  

            // Set the XMLTask properties.  
            myTask.OperationType = DTSXMLOperation.Validate;  
            myTask.SourceType = DTSXMLSourceType.FileConnection;  
            myTask.Source = connMgr.Name;  

            DTSExecResult valResults = pkg.Validate(pkg.Connections, pkg.Variables, null, null);  
            Console.WriteLine("RESULTS: {0}", valResults);  
        }  
    }  
}

샘플 출력:

RESULTS: Success

설명

이 방법은 값과 상관 OperationType 없이 에 대해 XMLTask사용할 수 있습니다.

Validate 이 방법은 속성과 설정을 검토하여 부정확성이나 잘못된 설정을 확인합니다. 이 방법은 데이터를 건드리거나 연결 검증을 위해 데이터 소스에 연결하지 않습니다. 하지만 필수 필드가 채워지고 적절한 값을 포함하도록 보장합니다. 검증되는 필드는 검증되는 객체에 따라 다릅니다.

주요 용도 Validate 는 맞춤형 작업을 작성할 때입니다. Validate 이 메서드는 작업이 설계 표면에 올라갈 때 SSIS 디자이너가 호출하며, 속성이 설정될 때도 여러 번 호출됩니다. 하지만 코드 Validate 에서는 개별 객체에 대한 메서드를 일반적으로 사용하지 않으며, 객체를 검증할 때 메서드를 호출 ValidatePackage 하는 것이 권장됩니다. 하지만 특별한 상황에 따라 개별 물체에 대해서는 이 방법이 가능합니다.

이 메서드는 Validate SSIS 디자이너에서 객체를 검증하거나 코드로 호출될 때 사용자 지정 작업에서 덮어쓰입니다. 커스텀 작업 메서드 작성 Validate 에 대한 자세한 내용은 ' 커스텀 태스크 코딩'을 참조하세요.

적용 대상