ListViewUpdateEventArgs.NewValues Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene un diccionario que contiene los valores revisados del elemento que se va a actualizar.
public:
property System::Collections::Specialized::IOrderedDictionary ^ NewValues { System::Collections::Specialized::IOrderedDictionary ^ get(); };
public System.Collections.Specialized.IOrderedDictionary NewValues { get; }
member this.NewValues : System.Collections.Specialized.IOrderedDictionary
Public ReadOnly Property NewValues As IOrderedDictionary
Valor de propiedad
Valores revisados del elemento que se va a actualizar.
Ejemplos
En el ejemplo siguiente se muestra cómo usar la NewValues propiedad para asegurarse de que el usuario ha proporcionado todos los valores antes de actualizar el origen de datos. Este ejemplo de código es parte de un ejemplo mayor proporcionado para la clase ListViewUpdateEventArgs.
void ContactsListView_ItemUpdating(Object sender, ListViewUpdateEventArgs e)
{
// Cancel the update operation if any of the fields is empty
// or null.
foreach (DictionaryEntry de in e.NewValues)
{
// Check if the value is null or empty.
if (de.Value == null || de.Value.ToString().Trim().Length == 0)
{
Message.Text = "Cannot set a field to an empty value.";
e.Cancel = true;
}
}
// Convert the email address to lowercase.
String emailValue = e.NewValues["EmailAddress"].ToString();
e.NewValues["EmailAddress"] = emailValue.ToLower();
}
Sub ContactsListView_ItemUpdating(ByVal sender As Object, ByVal e As ListViewUpdateEventArgs)
' Cancel the update operation if any of the fields is empty
' or null.
For Each de As DictionaryEntry In e.NewValues
' Check if the value is null or empty
If de.Value Is Nothing OrElse de.Value.ToString().Trim().Length = 0 Then
Message.Text = "Cannot set a field to an empty value."
e.Cancel = True
End If
Next
' Convert the email address to lowercase.
Dim emailValue As String = e.NewValues("EmailAddress").ToString()
e.NewValues("EmailAddress") = emailValue.ToLower()
End Sub
Comentarios
Use la NewValues propiedad (diccionario) para tener acceso a los valores de los campos no clave revisados del elemento que se va a actualizar.
Nota
El campo o los campos de clave principal se incluyen en este diccionario si se actualizan los valores o el valor de la clave principal. Para tener acceso a los valores originales del campo o campos de clave principal, use la Keys propiedad . Para tener acceso a los valores originales de los campos que no son clave del elemento, use la OldValues propiedad .
La NewValues propiedad se rellena automáticamente con los pares nombre-valor de los campos revisados del elemento. Se agrega una entrada independiente a la NewValues propiedad para cada campo del elemento.
Para determinar el nombre de campo de una entrada, use la DictionaryEntry.Key propiedad de un DictionaryEntry objeto contenido en el NewValues diccionario. Para determinar el valor de una entrada, use la DictionaryEntry.Value propiedad .
Se aplica a
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de