XMLTask.Validate 메서드

정의

네임스페이스:

Microsoft.SqlServer.Dts.Tasks.XMLTask

어셈블리:

Microsoft.SqlServer.XMLTask.dll

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

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 . 작업을 만든 후 여러 속성을 설정한 다음 , 의 메서드를 Validate 호출합니다 Package.

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

설명

이 메서드는 값에 XMLTask관계 없이 OperationType 사용할 수 있습니다.

메서드는 Validate 부정확하거나 잘못된 설정에 대한 속성 및 설정을 검토합니다. 이 메서드는 데이터를 터치하거나 데이터 원본에 연결하여 연결의 유효성을 검사하지 않습니다. 그러나 필수 필드가 채워지고 적절한 값을 포함하도록 합니다. 유효성을 검사하는 필드는 유효성을 검사할 개체에 따라 다릅니다.

기본 사용 Validate 은 사용자 지정 작업을 작성할 때입니다. 이 Validate 메서드는 SSIS 디자이너에서 작업이 디자인 화면에 놓일 때 호출되고 속성이 설정될 때 잠재적으로 여러 번 호출됩니다. 그러나 코드에서는 개체의 Validate 유효성을 검사해야 하는 경우 메서드 Package 를 호출 Validate 하는 것이 좋습니다. 그러나 필요한 고유한 상황을 찾으면 개별 개체에서 메서드를 사용할 수 있습니다.

이 Validate 메서드는 SSIS 디자이너에서 사용할 때 개체의 유효성 검사를 위해 또는 코드에서 호출할 때 사용자 지정 작업에서 재정의됩니다. 사용자 지정 작업에 대한 메서드를 Validate 작성하는 방법에 대한 자세한 내용은 사용자 지정 태스크 코딩을 참조하세요.