다음을 통해 공유


IDTSDesigntimeComponent100.Validate 메서드

정의

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

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 열거형의 값입니다.

특성

설명

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

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

구성 요소는 유효성 검사에 실패할 때 사용자에게 피드백을 제공해야 합니다. 피드백은 및 메서드 및 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 디자인 타임 호출이 제거되고 대신 구성 요소 실행 전에 메서드가 호출됩니다.

적용 대상