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.IOrderedDictionaryPublic 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 変更されたキー以外のフィールドの値にアクセスするには、 プロパティ (ディクショナリ) を使用します。
注意
主キーの値が更新されている場合は、主キー フィールドまたは主キー フィールドがこのディクショナリに含まれます。 主キー フィールドまたは主キー フィールドの元の値にアクセスするには、 プロパティを Keys 使用します。 アイテム内のキー以外のフィールドの元の値にアクセスするには、 プロパティを OldValues 使用します。
プロパティには NewValues 、アイテム内の変更されたフィールドの名前と値のペアが自動的に設定されます。 アイテム内のすべてのフィールドに対して、個別の NewValues エントリが プロパティに追加されます。
エントリのフィールド名を確認するには、ディクショナリに DictionaryEntry.Key 含まれるオブジェクトの DictionaryEntry プロパティを NewValues 使用します。 エントリの値を確認するには、 プロパティを DictionaryEntry.Value 使用します。
適用対象
こちらもご覧ください
.NET