IDTSDesigntimeComponent100.Validate 메서드

정의

네임스페이스:

Microsoft.SqlServer.Dts.Pipeline.Wrapper

어셈블리:

Microsoft.SqlServer.DTSPipelineWrap.dll

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

public:
 Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();

[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();

[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus

Public Function Validate () As DTSValidationStatus

반환

DTSValidationStatus

구성 요소의 상태를 나타내는 DTSValidationStatus 열거형의 값입니다.

특성

DispIdAttribute

설명

메서드는 Validate 구성 요소 개발자가 구성 요소가 올바르게 구성되었는지 확인하기 위해 구현됩니다. 패키지 디자인 중에 반복적으로 호출되고 구성 요소를 실행하기 전에 한 번 호출됩니다. 구성 요소는 동안 Validate해당 IDTSComponentMetaData100 구성 요소를 수정해서는 안 됩니다.

각 구성 요소에는 성공적인 유효성 검사를 위한 요구 사항이 다르지만 다음 목록에서는 유효성을 검사해야 하는 몇 가지 일반적인 항목을 제공합니다.

• 구성 요소에 예상된 수의 IDTSInput100 및 IDTSOutput100 개체가 있는지 확인합니다.

• 개체 IDTSCustomProperty100 가 계속 존재하고 올바른 값을 포함하는지 확인합니다.

• 해당 IDTSInputColumnCollection100 개체의 각 IDTSInputColumn100 개체가 업스트림 구성 요소의 기존 IDTSOutputColumn100 개체를 참조하는지 확인합니다.

• 구성 요소에서 연결을 사용하는 경우 가 지정되고 ConnectionManager 가 패키지에 있는지 확인 IDTSRuntimeConnection100 합니다.

구성 요소는 유효성 검사에 실패할 때 사용자에게 피드백을 제공해야 합니다. 피드백은 및 메서드 및 FireWarningDTSValidationStatus 반환 값을 통해 FireError 제공됩니다. 및 메서드에 FireError 대한 호출은 SQL Server Data Tools(SSDT)의 작업 목록 창에 표시되며 유효성 검사 실패에 대한 사용자 지침을 제공해야 합니다.FireWarning 열거형의 4개 값 DTSValidationStatus 중 유효성 검사 성공만 VS_ISVALID 나타냅니다. 다른 세 가지 값은 서로 다른 실패 수준을 나타냅니다. 다음 표에서는 열거형의 실패 값과 SSIS 디자이너에서 오류 값을 해석하는 방법을 설명합니다.

상태	Description
VS_ISBROKEN	구성 요소가 올바르게 구성되지 않음을 나타냅니다. 사용자가 문제를 해결하려면 을 ComponentMetaData 변경해야 합니다.
VS_NEEDSNEWMETADATA	메서드 구현에서 구성 요소에서 ReinitializeMetaData 유효성 검사 오류를 해결할 수 있음을 나타냅니다. SSIS 디자이너는 열거형 값 VS_NEEDSNEWMETADATA이 일 때 구성 요소가 자체 복구할 수 있음을 사용자에게 묻는 메시지를 표시합니다. 그런 다음 디자이너가 메서드를 호출합니다 ReinitializeMetaData .
VS_ISCORRUPT	가 ComponentMetaData 손상되었으며 메서드를 호출 ReinitializeMetaData 하거나 구성 요소를 편집하여 복구할 수 없음을 나타냅니다.

데이터 흐름 태스크의 속성이 DelayValidation 이면 true메서드에 대한 Validate 디자인 타임 호출이 제거되고 대신 구성 요소 실행 전에 메서드가 호출됩니다.