Package.LoadFromXML(String, IDTSEvents) Metode

Referensi

Definisi

Ruang nama:: Microsoft.SqlServer.Dts.Runtime

Rakitan:: Microsoft.SqlServer.ManagedDTS.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Memuat paket dan semua objeknya yang telah disimpan ke memori dalam format XML. Untuk memuat paket yang disimpan ke hard drive, gunakan metode .LoadPackage(String, IDTSEvents)

public:
 void LoadFromXML(System::String ^ packageXml, Microsoft::SqlServer::Dts::Runtime::IDTSEvents ^ events);

public void LoadFromXML (string packageXml, Microsoft.SqlServer.Dts.Runtime.IDTSEvents events);

override this.LoadFromXML : string * Microsoft.SqlServer.Dts.Runtime.IDTSEvents -> unit

Public Sub LoadFromXML (packageXml As String, events As IDTSEvents)

Parameter

packageXml: String

String yang berisi paket dalam format XML.

events: IDTSEvents

Objek yang mengimplementasikan IDTSEvents antarmuka untuk menembakkan peristiwa (kesalahan, peringatan, dan sebagainya) selama persistensi.

Contoh

Contoh kode berikut membuat paket dan menambahkan dua tugas ke dalamnya. XML paket disimpan ke XmlDocument dalam memori. Paket kedua dibuat, dan karena dimuat dengan yang sama XmlDocument, sekarang menjadi duplikat paket pertama.

using System;  
using System.Collections.Generic;  
using System.Text;    
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Tasks.BulkInsertTask;  
using System.Xml;  

namespace Microsoft.SqlServer.SSIS.Samples  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            Application app = new Application();  

            // Location and file name can be combined into one string,   
            // or location could be set by a variable instead of   
            // hard-coded.  
            String XmlLocation = @"C:\XML";  
            String XmlFileName = "TestXML.xml";  
            String XmlFile = XmlLocation + XmlFileName;  
            Package pkg = new Package();  
            pkg.CreatorName = "Test";  
            pkg.Name = "SaveToXML Package";  
            pkg.CheckSignatureOnLoad = true;  
            pkg.DelayValidation = false;  
            pkg.SaveCheckpoints = false;  

            // Create package XmlDocument and use in pkg.SaveToXml.  
            XmlDocument myPkgDocument = new XmlDocument();  
            pkg.SaveToXML(ref myPkgDocument, null, null);  
            // If you want to see what the package XML contains   
            // at this point, uncomment this line and view the console.  
            // Console.Out.WriteLine(myPkgDocument.OuterXml);  

            // Now modify the package. Create a task   
            // and set some properties.  
            Executable execBI = pkg.Executables.Add("STOCK:BulkInsertTask");  
            TaskHost th = execBI as TaskHost;  
            th.Properties["DebugMode"].SetValue(th, false);  

            // Save the task into the package using pkg.SaveToXML.  
            // This saves the package after it has been modified  
            // by the addition of the task.  
            pkg.SaveToXML(ref myPkgDocument, null, null);  

            // When you want to save the package to the hard-drive,  
            // Save using the Application.SaveToXML method.  
            //app.SaveToXml(XmlFile, pkg, null);  

            // Reload the package from its XML.  
            Package pkg2 = new Package();  
            pkg2.LoadFromXML(myPkgDocument, null);  
            Console.WriteLine("This is the package XML that pkg2 now contains:");  
            Console.Out.WriteLine(myPkgDocument.OuterXml);  
        }  
    }  
}

Imports System  
Imports System.Collections.Generic  
Imports System.Text    
Imports Microsoft.SqlServer.Dts.Runtime  
Imports Microsoft.SqlServer.Dts.Tasks.BulkInsertTask  
Imports System.Xml  

Namespace Microsoft.SqlServer.SSIS.Samples  
    Class Program  
        Shared  Sub Main(ByVal args() As String)  
            Dim app As Application =  New Application()   

            ' Location and file name can be combined into one string,   
            ' or location could be set by a variable instead of   
            ' hard-coded.  
            Dim XmlLocation As String =  "C:\XML"   
            Dim XmlFileName As String =  "TestXML.xml"   
            Dim XmlFile As String =  XmlLocation + XmlFileName   
            Dim pkg As Package =  New Package()   
            pkg.CreatorName = "Test"  
            pkg.Name = "SaveToXML Package"  
            pkg.CheckSignatureOnLoad = True  
            pkg.DelayValidation = False  
            pkg.SaveCheckpoints = False  

            ' Create package XmlDocument and use in pkg.SaveToXml.  
            Dim myPkgDocument As XmlDocument =  New XmlDocument()   
            pkg.SaveToXML( myPkgDocument,Nothing,Nothing)  
            ' If you want to see what the package XML contains   
            ' at this point, uncomment this line and view the console.  
            ' Console.Out.WriteLine(myPkgDocument.OuterXml);  

            ' Now modify the package. Create a task   
            ' and set some properties.  
            Dim execBI As Executable =  pkg.Executables.Add("STOCK:BulkInsertTask")   
            Dim th As TaskHost =  execBI as TaskHost   
            th.Properties("DebugMode").SetValue(th, False)  

            ' Save the task into the package using pkg.SaveToXML.  
            ' This saves the package after it has been modified  
            ' by the addition of the task.  
            pkg.SaveToXML( myPkgDocument,Nothing,Nothing)  

            ' When you want to save the package to the hard-drive,  
            ' Save using the Application.SaveToXML method.  
            'app.SaveToXml(XmlFile, pkg, null);  

            ' Reload the package from its XML.  
            Dim pkg2 As Package =  New Package()   
            pkg2.LoadFromXML(myPkgDocument, Nothing)  
            Console.WriteLine("This is the package XML that pkg2 now contains:")  
            Console.Out.WriteLine(myPkgDocument.OuterXml)  
        End Sub  
    End Class  
End Namespace

Keterangan

Anda harus menggunakan LoadFromXML metode untuk memuat XML yang ada dalam memori. Jika Anda ingin memuat paket yang telah disimpan ke hard drive sebagai XML, gunakan metode .Microsoft.SqlServer.Dts.Runtime.Application.LoadPackage Jika paket telah disimpan ke Sistem File atau database MSDB, gunakan Microsoft.SqlServer.Dts.Runtime.Application.LoadFromSqlServer metode atau Microsoft.SqlServer.Dts.Runtime.Application.LoadFromDtsServer .

Ketika Anda memanggil salah satu metode pemuatan pada Application, runtime akan melakukan iterasi melalui tugas, manajer koneksi, penyedia log, dan semua objek lain yang dimuat oleh paket dan memanggil LoadFromXML metode pada masing-masing dari mereka. Objek yang terkandung memiliki kode di dalamnya LoadFromXML yang mengurai XmlElement untuk setiap properti yang harus dibuat ulang objek, dan nilai yang disimpan untuk elemen . Oleh karena itu, Anda tidak secara langsung memanggil LoadFromXML pada objek individual, tetapi memanggil metode pada Application objek , dan runtime akan berdiskade melalui paket dan memanggil LoadFromXML pada objek untuk Anda.

Berlaku untuk

Share via