ScriptTask.SaveToXML(XmlDocument, IDTSInfoEvents) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Implementa a gravação de propriedades em documento XML.
public:
virtual void SaveToXML(System::Xml::XmlDocument ^ doc, Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);
public void SaveToXML (System.Xml.XmlDocument doc, Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);
abstract member SaveToXML : System.Xml.XmlDocument * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> unit
override this.SaveToXML : System.Xml.XmlDocument * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> unit
Public Sub SaveToXML (doc As XmlDocument, events As IDTSInfoEvents)
Parâmetros
- doc
- XmlDocument
O documento XML do qual carregar.
- events
- IDTSInfoEvents
Interface para gerar eventos (erros, avisos etc.) durante a persistência.
Implementações
Comentários
Esse método está SaveToXMLdisponível porque é público em uma interface que você herda ao criar objetos personalizados e por objetos enviados no runtime do SSIS. Esse método destina-se apenas à herança e não deve ser chamado do código para outras finalidades. Se você estiver criando um objeto personalizado e precisar de informações sobre como escrever seu próprio SaveToXML
método, consulte Estender Pacotes com Objetos Personalizados.
Se você quiser salvar um pacote como XML, use o Microsoft.SqlServer.Dts.Runtime.Application.SaveToXml método. Se você quiser salvar o pacote no Sistema de Arquivos, use Microsoft.SqlServer.Dts.Runtime.Application.SaveToDtsServer. Se você quiser salvar o pacote no banco de dados MSDB, use Microsoft.SqlServer.Dts.Runtime.Application.SaveToSqlServer ou Microsoft.SqlServer.Dts.Runtime.Application.SaveToSqlServerAs métodos. Quando você chama os Microsoft.SqlServer.Dts.Runtime.Application.SaveToXml métodos no Application, o runtime itera por meio das tarefas, gerenciadores de conexões, provedores de log e todos os outros objetos contidos pelo pacote e chama o SaveToXML
método em cada um deles. Os objetos contidos têm um código que SaveToXML
cria um XmlElement para cada propriedade que o objeto deve salvar e um valor para o elemento. O pacote contém o XmlDocument e os objetos acrescentam seus elementos específicos ao XmlDocument do pacote. Portanto, você não chama diretamente os SaveToXML
objetos individuais, mas chama o método no Application objeto e o runtime será em cascata pelos objetos do pacote e chamará o SaveToXML
para você.