ConnectionManager.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
.