ForEachVariableMapping.SaveToXML(XmlDocument, XmlNode, IDTSEvents) 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.
Esse método não pode ser chamado por seu código de aplicativo. Para salvar um pacote como .xml, use o método 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 -> unitPublic Sub SaveToXML (ByRef doc As XmlDocument, node As XmlNode, events As IDTSEvents)Parâmetros
- doc
- XmlDocument
O documento XML no qual salvar as informações.
- node
- XmlNode
O nó no documento acima no qual salvar as informações.
- events
- IDTSEvents
Um objeto que implementa a interface IDTSEvents de eventos (erros, avisos, etc.) acionados durante a persistência.
Implementações
Comentários
Esse método SaveToXML está disponí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ê.