ListViewUpdateEventArgs.NewValues 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得包含要更新之項目修訂值的字典。
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
屬性值
要更新之項目的修訂值。
範例
下列範例示範如何使用 NewValues 屬性,確保使用者已在更新數據源之前提供所有值。 此程式代碼範例是提供給 類別之較大範例的 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
備註
NewValues使用 屬性 (字典) 來存取專案中修訂的非索引鍵欄位的值,以便更新。
屬性 NewValues 會自動填入項目中修訂欄位的名稱/值組。 個別專案會新增至 NewValues 專案中每個欄位的屬性。
若要判斷專案的功能變數名稱,請使用DictionaryEntry.Key字典中包含的 NewValues 物件屬性DictionaryEntry。 若要判斷專案的值,請使用 DictionaryEntry.Value 屬性。