IDTSDesigntimeComponent100.Validate 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
驗證元件是否正確設定。
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.DTSValidationStatusPublic Function Validate () As DTSValidationStatus傳回
列舉中的一個值 DTSValidationStatus ，表示元件的狀態。
- 屬性
備註
此 Validate 方法由元件開發者實作，以驗證元件是否正確配置。 在套件設計過程中會反覆呼叫，並在元件執行前呼叫一次。 元件不應在 IDTSComponentMetaData100Validate。
每個元件對成功驗證的要求不同，但以下列出一些常見且應被驗證的項目。
確認元件是否擁有預期數量 IDTSInput100 的 和 IDTSOutput100 物件。
確認任何 IDTSCustomProperty100 物件仍然存在且包含正確的值。
驗證其每個IDTSInputColumn100IDTSInputColumnCollection100物件是否參考上游元件中的現有IDTSOutputColumn100物件。
如果元件使用連線，請確認 是 IDTSRuntimeConnection100 指定 ConnectionManager 且 是否存在於封包中。
元件應在驗證失敗時向使用者提供回饋。 回饋透過 FireError and FireWarning 方法及 DTSValidationStatus 返回值提供。 呼叫 FireError 和 FireWarning 方法的資訊會顯示在 SQL Server Data Tools（SSDT）的任務清單視窗中，並應為使用者提供驗證失敗的指引。 列舉中的 DTSValidationStatus 四個值中，僅 VS_ISVALID 表示驗證成功。 另外三個數值代表不同的故障程度。 下表說明列舉中的故障值，以及 SSIS Designer 如何解讀這些值。
| 狀態 | 描述 |
|---|---|
| VS_ISBROKEN | 表示元件設定不正確。 使用者必須對 THE 進行 ComponentMetaData 修改以解決問題。 |
| VS_NEEDSNEWMETADATA | 表示驗證錯誤可由元件在方法 ReinitializeMetaData 實作中修正。 當列舉值為 VS_NEEDSNEWMETADATA時，SSIS 設計器會提示使用者該元件可以自我修復。 然後設計師會呼叫該 ReinitializeMetaData 方法。 |
| VS_ISCORRUPT | 表示 已 ComponentMetaData 損壞，無法透過呼叫 ReinitializeMetaData 方法或編輯元件來修復。 |
當資料流程任務的 DelayValidation 屬性為 true時，會省去設計時對 Validate 方法的呼叫，改為在元件執行前呼叫該方法。