DataDOMEvent.NewValue Propriedade
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.
Obtém o valor de um nó DOM (Modelo de Objeto de Documento XML) que está sendo atualizado ou inserido durante um evento de validação de dados.
public:
property System::Object ^ NewValue { System::Object ^ get(); };
public object NewValue { get; }
member this.NewValue : obj
Public ReadOnly Property NewValue As Object
Valor da propriedade
Exemplos
No exemplo a seguir, a OldValue propriedade do DataDOMEventObject objeto é usada para exibir o valor original de um nó XML DOM, juntamente com seu NewValue:
thisXDocument.UI.Alert("Original value: " + e.OldValue.ToString() + "\nNew value: " + e.<span class="label">NewValue</span>.ToString());
No exemplo a seguir, a propriedade NewValue do DataDOMEvent é marcada para obter um valor em branco. Se não estiverem em branco, os campos "FirstName" e "Lastname" serão limpos.
if (e.IsUndoRedo)
{
// An undo or redo operation has occurred and the DOM is read-only.
return;
}
// A field change has occurred and the DOM is writable. Write code here to respond
// to the changes.
if (e.<span class="label">NewValue</span>.ToString() == "")
return;
if (thisXDocument.DOM.selectSingleNode("/dfs:myFields/dfs:queryFields/q:Employees/@FirstName").text != "")
thisXDocument.DOM.selectSingleNode("/dfs:myFields/dfs:queryFields/q:Employees/@FirstName").text = "";
if (thisXDocument.DOM.selectSingleNode("/dfs:myFields/dfs:queryFields/q:Employees/@LastName").text != "")
thisXDocument.DOM.selectSingleNode("/dfs:myFields/dfs:queryFields/q:Employees/@LastName").text = "";
Comentários
A propriedade NewValue contém o valor do nó XML DOM que substituirá o valor existente. Para obter o valor original do nó XML DOM, use a OldValue propriedade.
Importante: esse membro só pode ser acessado por formulários em execução no mesmo domínio que o formulário aberto atualmente ou por formulários que receberam permissões entre domínios.