Metoda PipelineComponent.Validate
Weryfikuje, że składnik jest prawidłowo skonfigurowany.
Ten interfejs API nie jest zgodny ze specyfikacją CLS.
Przestrzeń nazw: Microsoft.SqlServer.Dts.Pipeline
Zestaw: Microsoft.SqlServer.PipelineHost (w Microsoft.SqlServer.PipelineHost.dll)
Składnia
'Deklaracja
<CLSCompliantAttribute(False)> _
Public Overridable Function Validate As DTSValidationStatus
'Użycie
Dim instance As PipelineComponent
Dim returnValue As DTSValidationStatus
returnValue = instance.Validate()
[CLSCompliantAttribute(false)]
public virtual DTSValidationStatus Validate()
[CLSCompliantAttribute(false)]
public:
virtual DTSValidationStatus Validate()
[<CLSCompliantAttribute(false)>]
abstract Validate : unit -> DTSValidationStatus
[<CLSCompliantAttribute(false)>]
override Validate : unit -> DTSValidationStatus
public function Validate() : DTSValidationStatus
Wartość zwracana
Typ: Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus
Wartość z DTSValidationStatus wyliczenia, który wskazuje stan składnika.
Uwagi
Validate Metoda jest zastąpiona przez deweloperów składnika, aby zweryfikować, że składnik jest prawidłowo skonfigurowany.Jest wywoływany cyklicznie podczas projektowania pakiet i jeden czas przed wykonaniem składnika.Składniki nie należy modyfikować jego ComponentMetaData podczas Validate.
Implementacja klasy podstawowej z Validate sprawdza istnienie IDTSInputColumn100 obiektów, których LineageID właściwość nie pasuje do LineageID z IDTSOutputColumn100 składnika nadrzędnego.Deweloperzy składników należy rozszerzyć klasy bazowej Validate funkcjonalność, wykonując dodatkowe kontrole na ComponentMetaData.Każdy składnik posiada różne wymogi dotyczące sprawdzeniu poprawności, ale poniżej przedstawiono niektóre z typowych elementów, które powinny zostać zatwierdzone.
Sprawdź, czy składnik ma oczekiwanej liczby IDTSInput100 i IDTSOutput100 obiektów.
Zweryfikuj, że jakaś IDTSCustomProperty100 obiekty nadal istnieje i zawierają prawidłowe wartości.
Jeśli składnik używa połączenia, to należy sprawdzić, czy IDTSRuntimeConnection100 jest określony, a ConnectionManager istnieje w pakiet.
Składniki powinny przekazywać opinie użytkowników podczas sprawdzania poprawności nie powiedzie się.Opinia jest zapewniana przez FireError i FireWarning metod oraz DTSValidationStatus zwraca wartość.Wzywa do FireError i FireWarning są wyświetlane w Lista błędów okna Business Intelligence Development Studioi powinien zapewnić użytkowników w błąd sprawdzania poprawności.Cztery wartości w DTSValidationStatus wyliczania, tylko VS_ISVALID wskazuje pomyślnie sprawdzania poprawności.Trzy wartości wskazują różne poziomy awarii.W poniższej tabela opisano wartości Niepowodzenie wyliczania i jak są one interpretowane przez projektanta SSIS.
Stan |
Opis |
|---|---|
Wskazuje składnik nie niepoprawnie, skonfigurowany ale zmiany wprowadzone przez użytkownika do ComponentMetaData rozwiąże problemy. |
|
Wskazuje, że błędy sprawdzania poprawności można ustalić przez składnik w celu jej wykonania ReinitializeMetaData metoda.Projektant SSIS będzie monitował użytkowników składnika automatycznej naprawy podczas VS_NEEDSNEWMETADATA, a następnie ReinitializeMetaData nosi. |
|
Wskazuje, że ComponentMetaData jest uszkodzony i nie można naprawić przez wywołanie ReinitializeMetaData lub zmiany składnika. |
Gdy DelayValidation Właściwość zadania przepływ danych jest true, projekt czas wywołań Validate są eliminowane i metoda jest wywoływana przed wykonanie składnika.
Aby uzyskać więcej informacji, zobacz temat Sprawdzanie poprawności składnika przepływu danych.