Udostępnij za pośrednictwem

  • Artykuł

Metoda XMLTask.Validate

Weryfikuje, że składnik jest prawidłowo skonfigurowany.

Przestrzeń nazw:  Microsoft.SqlServer.Dts.Tasks.XMLTask
Zestaw:  Microsoft.SqlServer.XMLTask (w Microsoft.SqlServer.XMLTask.dll)

Składnia

'Deklaracja
Public Overrides Function Validate ( _
    connections As Connections, _
    variableDispenser As VariableDispenser, _
    events As IDTSComponentEvents, _
    log As IDTSLogging _
) As DTSExecResult
'Użycie
Dim instance As XMLTask
Dim connections As Connections
Dim variableDispenser As VariableDispenser
Dim events As IDTSComponentEvents
Dim log As IDTSLogging
Dim returnValue As DTSExecResult

returnValue = instance.Validate(connections, _
    variableDispenser, events, log)

public override DTSExecResult Validate(
    Connections connections,
    VariableDispenser variableDispenser,
    IDTSComponentEvents events,
    IDTSLogging log
)

public:
virtual DTSExecResult Validate(
    Connections^ connections, 
    VariableDispenser^ variableDispenser, 
    IDTSComponentEvents^ events, 
    IDTSLogging^ log
) override

abstract Validate : 
        connections:Connections * 
        variableDispenser:VariableDispenser * 
        events:IDTSComponentEvents * 
        log:IDTSLogging -> DTSExecResult 
override Validate : 
        connections:Connections * 
        variableDispenser:VariableDispenser * 
        events:IDTSComponentEvents * 
        log:IDTSLogging -> DTSExecResult 

public override function Validate(
    connections : Connections, 
    variableDispenser : VariableDispenser, 
    events : IDTSComponentEvents, 
    log : IDTSLogging
) : DTSExecResult

Parametry

Wartość zwracana

Typ: Microsoft.SqlServer.Dts.Runtime.DTSExecResult
Wartość z DTSExecResult wyliczania.

Uwagi

Ta metoda jest dostępna do XMLTask, niezależnie od OperationType wartości.

Sprawdzania poprawności metoda przegląda właściwości i ustawień niedokładności lub niepoprawne ustawienia.Metoda nie dotykać danych lub połączenie do sprawdzania poprawności połączeń ze źródłami danych.Jednakże zapewnia, że wymagane pola są wypełniane i zawierają odpowiednie wartości.Pól, których poprawność różnią się w zależności od tego, jaki obiekt jest sprawdzany.

Podstawowym zastosowaniem sprawdzania poprawności jest podczas zapisywania niestandardowego zadania.Sprawdzania poprawności metoda jest wywoływana przez projektanta SSIS po upuszczeniu na powierzchnię projektu zadania i ponownie, potencjalnie wiele razy, gdy właściwości są zestaw.Jednak w kodzie sprawdzania poprawności w poszczególnych obiektach używana jest metoda nie powszechnie, zalecane, można wywołać sprawdzania poprawności metody na Package , gdy konieczne jest sprawdzenie poprawności obiektów.Jednak metoda jest dostępna w poszczególnych obiektach powinny możesz znaleźć unikatowy okoliczności tam, gdzie to konieczne.

Sprawdzania poprawności metoda jest zastąpiona w niestandardowe zadania dla obiektu używany w projektancie SSIS lub kiedy wywoływana przez kod sprawdzania poprawności.Więcej informacji na temat pisania sprawdzania poprawności metoda dla niestandardowego zadania, zobacz Kodowanie niestandardowego zadania.

Przykłady

Poniższy kod ilustruje tworzenie XMLTask jako część pakiet.Po utworzeniu zadania ustawia kilka właściwości, a następnie wywołuje sprawdzania poprawności metoda 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);
        }
    }
}

Przykład danych wyjściowych:

RESULTS: Success