XObject.Changing Evento
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.
Acionado quando esse XObject ou um de seus descendentes está prestes a mudar.
public:
event EventHandler<System::Xml::Linq::XObjectChangeEventArgs ^> ^ Changing;
public event EventHandler<System.Xml.Linq.XObjectChangeEventArgs> Changing;
member this.Changing : EventHandler<System.Xml.Linq.XObjectChangeEventArgs>
Public Custom Event Changing As EventHandler(Of XObjectChangeEventArgs)
O exemplo a seguir adiciona um manipulador de eventos ao elemento raiz de uma árvore XML. Em seguida, ele modifica a árvore, fazendo com que LINQ to XML gere alguns eventos.
XElement root = new XElement("Root", "content");
root.Changing += new EventHandler<XObjectChangeEventArgs>(
(sender, cea) =>
{
Console.WriteLine("Changing event raised");
XElement xSender = (XElement)sender;
Console.WriteLine(" Sender: {0}", xSender.Name);
Console.WriteLine(" ObjectChange: {0}", cea.ObjectChange);
}
);
root.Changed += new EventHandler<XObjectChangeEventArgs>(
(sender, cea) =>
{
Console.WriteLine("Changed event raised");
XElement xSender = (XElement)sender;
Console.WriteLine(" Sender: {0}", xSender.Name);
Console.WriteLine(" ObjectChange: {0}", cea.ObjectChange);
}
);
root.Add(new XElement("Child", "child content"));
Module Module1
WithEvents root As XElement = <Root>content</Root>
Sub Main()
root.Add(<Child>child content</Child>)
End Sub
Private Sub root_Changing( _
ByVal sender As Object, _
ByVal e As XObjectChangeEventArgs) _
Handles root.Changing
Dim xSender As XElement = CType(sender, XElement)
Console.WriteLine("Changing event raised")
Console.WriteLine(" Sender: {0}", xSender.Name)
Console.WriteLine(" ObjectChange: {0}", e.ObjectChange)
End Sub
Private Sub root_Changed( _
ByVal sender As Object, _
ByVal e As XObjectChangeEventArgs) _
Handles root.Changed
Dim xSender As XElement = CType(sender, XElement)
Console.WriteLine("Changed event raised")
Console.WriteLine(" Sender: {0}", xSender.Name)
Console.WriteLine(" ObjectChange: {0}", e.ObjectChange)
End Sub
End Module
Esse exemplo gera a saída a seguir:
Changing event raised
Sender: Child
ObjectChange: Add
Changed event raised
Sender: Child
ObjectChange: Add
Os eventos são gerados somente a partir da modificação de uma árvore XML, não da construção de uma árvore XML. Você precisa adicionar um manipulador de eventos a um evento antes de receber eventos e não pode adicionar um manipulador de eventos antes de ter uma referência a um XObject. Você não pode obter uma referência a um XObject antes que a árvore XML seja construída. Isso significa que, durante a construção funcional de uma árvore XML, você não receberá eventos.
Você deve ter cuidado ao modificar uma árvore XML dentro de um desses eventos, pois fazer isso pode levar a resultados inesperados. Por exemplo, se você receber um Changing evento e, enquanto o evento estiver sendo processado, você removerá o nó da árvore, talvez não receba o Changed evento. Quando um evento está sendo processado, é válido modificar uma árvore XML diferente daquela que contém o nó que está recebendo o evento; É válido até mesmo modificar a mesma árvore, desde que as modificações não afetem os nós específicos nos quais o evento foi gerado. No entanto, se você modificar a área da árvore que contém o nó que recebe o evento, os eventos recebidos e o impacto na árvore serão indefinidos.
Produto | Versões |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: