TransferSqlServerObjectsTask.LoadFromXML(XmlElement, IDTSInfoEvents) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
This method is not callable by your application code. To load a package saved as .xml, use the LoadPackage(String, IDTSEvents) method.
public:
virtual void LoadFromXML(System::Xml::XmlElement ^ rootNode, Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);public void LoadFromXML (System.Xml.XmlElement rootNode, Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);abstract member LoadFromXML : System.Xml.XmlElement * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> unit
override this.LoadFromXML : System.Xml.XmlElement * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> unitPublic Sub LoadFromXML (rootNode As XmlElement, events As IDTSInfoEvents)Parameters
- rootNode
- XmlElement
The node that contains the information to be loaded.
- events
- IDTSInfoEvents
An object that implements the IDTSInfoEvents interface for raising events (errors, warnings, and so on) during persistence.
Implements
Remarks
This method, LoadFromXML, is available because it is public on an interface that you inherit when you are creating custom objects and by objects shipped in the SSIS runtime. This method is intended for inheritance only and should not be called from code for other purposes. If you are creating a custom object and need information about how to write your own LoadFromXML method, see Extending Packages with Custom Objects.
If you want to load a package that has been saved as XML, use the Microsoft.SqlServer.Dts.Runtime.Application.LoadPackage method. If the package has been saved to the File System or MSDB database, use the Microsoft.SqlServer.Dts.Runtime.Application.LoadFromSqlServer or Microsoft.SqlServer.Dts.Runtime.Application.LoadFromDtsServer methods.
When you call any of the loading methods on the Application, the runtime will iterate through the tasks, connection managers, log providers, and all other objects that are contained by the package and call the LoadFromXML method on each of them. The contained objects have code in their LoadFromXML that parses the XmlElement for each property that the object must recreate, and the value saved for the element. Therefore, you do not directly call the LoadFromXML on the individual objects, but call the method on the Application object, and the runtime will cascade through the package and call the LoadFromXML on the objects for you.