ListViewInsertEventArgs.Values Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.Extensions.dll

Ruft die Werte für den einzufügenden Datensatz ab.

public:
 property System::Collections::Specialized::IOrderedDictionary ^ Values { System::Collections::Specialized::IOrderedDictionary ^ get(); };
public System.Collections.Specialized.IOrderedDictionary Values { get; }
member this.Values : System.Collections.Specialized.IOrderedDictionary
Public ReadOnly Property Values As IOrderedDictionary

Eigenschaftswert

IOrderedDictionary

Die Werte für den einzufügenden Datensatz.

Beispiele

Das folgende Beispiel zeigt, wie Sie die Values Auflistung durchlaufen. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ListViewInsertEventArgs Klasse bereitgestellt wird.

void ContactsListView_ItemInserting(Object sender, ListViewInsertEventArgs e)
{
  // Iterate through the values to verify if they are not empty.
  foreach (DictionaryEntry de in e.Values)
  {
    if (de.Value == null)
    {
      Message.Text = "Cannot insert an empty value.";
      e.Cancel = true;
    }
  }
}

Sub ContactsListView_ItemInserting(ByVal sender As Object, _
                                   ByVal e As ListViewInsertEventArgs)

  ' Iterate through the values to verify if they are not empty.
  For Each de As DictionaryEntry In e.Values
    If de.Value Is Nothing Then
      Message.Text = "Cannot insert an empty value."
      e.Cancel = True
    End If
  Next
End Sub

Hinweise

Verwenden Sie die Values Eigenschaft, um auf die Werte der Felder für den Datensatz zuzugreifen, die eingefügt werden sollen. Sie können z. B. die Werte des Datensatzes überprüfen oder codieren, bevor sie in die Datenquelle eingefügt wird.

Die Values Eigenschaft gibt ein OrderedDictionary Objekt zurück, das die IOrderedDictionary Schnittstelle implementiert. Das OrderedDictionary Objekt enthält DictionaryEntry Objekte, die die Felder des Datensatzes darstellen. Verwenden Sie die Keys Eigenschaft des OrderedDictionary Objekts, um auf die Feldnamen zuzugreifen. Verwenden Sie die Values Eigenschaft, um auf die Feldwerte zuzugreifen.

Hinweis

Als Verknüpfung können Sie den Indexer des OrderedDictionary Objekts verwenden, um direkt auf die Feldwerte zuzugreifen. Der Vorteil der Verwendung des Indexers besteht darin, dass feldwerte direkt zurückgegeben werden. Datenquellensteuerelemente, die auf die Feldreihenfolge (z. B AccessDataSource. ) basieren, können nur nach Index auf Feldwerte zugreifen.

Gilt für

Siehe auch