LoggingOptions.SaveToXML(XmlDocument, XmlNode, IDTSEvents) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызов этого метода кодом вашего приложения невозможен. Для сохранения пакета в виде XML-файла используйте метод SaveToXml(String, Package, IDTSEvents).
public:
virtual void SaveToXML(System::Xml::XmlDocument ^ % doc, System::Xml::XmlNode ^ node, Microsoft::SqlServer::Dts::Runtime::IDTSEvents ^ events);
public void SaveToXML (ref System.Xml.XmlDocument doc, System.Xml.XmlNode node, Microsoft.SqlServer.Dts.Runtime.IDTSEvents events);
abstract member SaveToXML : XmlDocument * System.Xml.XmlNode * Microsoft.SqlServer.Dts.Runtime.IDTSEvents -> unit
override this.SaveToXML : XmlDocument * System.Xml.XmlNode * Microsoft.SqlServer.Dts.Runtime.IDTSEvents -> unit
Public Sub SaveToXML (ByRef doc As XmlDocument, node As XmlNode, events As IDTSEvents)
Параметры
- doc
- XmlDocument
XML-документ, в который сохраняется информация.
- node
- XmlNode
Узел в документе выше, в котором сохраняется информация.
- events
- IDTSEvents
Объект, реализующий интерфейс IDTSEvents.
Реализации
Комментарии
Этот метод доступен, SaveToXMLтак как он является общедоступным в интерфейсе, наследуемом при создании пользовательских объектов и объектами, поставляемым в среде выполнения служб SSIS. Этот метод предназначен только для наследования и не должен вызываться из кода для других целей. Если вы создаете пользовательский объект и хотите узнать, как написать собственный SaveToXML
метод, см. раздел "Расширение пакетов с помощью пользовательских объектов".
Если вы хотите сохранить пакет в формате XML, используйте Microsoft.SqlServer.Dts.Runtime.Application.SaveToXml этот метод. Если вы хотите сохранить пакет в файловой системе, используйте Microsoft.SqlServer.Dts.Runtime.Application.SaveToDtsServer. Если вы хотите сохранить пакет в базе данных MSDB, используйте Microsoft.SqlServer.Dts.Runtime.Application.SaveToSqlServer или Microsoft.SqlServer.Dts.Runtime.Application.SaveToSqlServerAs методы. При вызове Microsoft.SqlServer.Dts.Runtime.Application.SaveToXml методов Applicationсреды выполнения выполняется итерация по задачам, диспетчерам соединений, поставщикам журналов и всем другим объектам, содержащимся в пакете, и вызывать SaveToXML
метод для каждого из них. Содержащиеся объекты содержат код в них SaveToXML
, который создает XmlElement для каждого свойства, которое объект должен сохранить, и значение элемента. Пакет содержит XmlDocument, а объекты добавляют определенные элементы в xmlDocument пакета. Таким образом, вы не вызываете SaveToXML
напрямую отдельные объекты, но вызываете метод объекта Application , и среда выполнения будет каскадно через объекты пакета и вызывать SaveToXML
его.