DataView.RowFilter-Eigenschaft

Artikel
08/20/2007

Ruft den Ausdruck ab, mit dem die im DataView anzuzeigenden Zeilen gefiltert werden, oder legt diesen fest.

Namespace: System.Data
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overridable Property RowFilter As String
'Usage
Dim instance As DataView
Dim value As String

value = instance.RowFilter

instance.RowFilter = value

public virtual string RowFilter { get; set; }

public:
virtual property String^ RowFilter {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_RowFilter ()

/** @property */
public void set_RowFilter (String value)

public function get RowFilter () : String

public function set RowFilter (value : String)

Eigenschaftenwert

Eine Zeichenfolge, die angibt, wie Zeilen gefiltert werden sollen. Weitere Informationen finden Sie im Abschnitt Hinweise.

Hinweise

Ein RowFilter-Wert wird gebildet, indem Sie den Namen einer Spalte angeben, gefolgt von einem Operator und einem Wert, mit dem gefiltert werden soll. Der Wert muss in Anführungszeichen angegeben werden. Beispiel:

"LastName = 'Smith'"

Weitere Informationen finden Sie unter der Expression-Eigenschaft der DataColumn-Klasse.

Verwenden Sie den folgenden Ausdruck, wenn nur die Spalten mit NULL-Werten zurückgegeben werden sollen:

"Isnull(Col1,'Null Column') = 'Null Column'"

Beispiel

Im folgenden Beispiel wird eine DataView erstellt und deren RowFilter-Eigenschaft festgelegt.

Private Sub MakeDataView()
    Dim view As DataView = New DataView
    With view
        .Table = DataSet1.Tables("Suppliers")
        .AllowDelete = True
        .AllowEdit = True
        .AllowNew = True
        .RowFilter = "City = 'Berlin'"
        .RowStateFilter = DataViewRowState.ModifiedCurrent
        .Sort = "CompanyName DESC"
    End With
    
    ' Simple-bind to a TextBox control
    Text1.DataBindings.Add("Text", view, "CompanyName")
End Sub

private void MakeDataView() 
{
    DataView view = new DataView();

    view.Table = DataSet1.Tables["Suppliers"];
    view.AllowDelete = true;
    view.AllowEdit = true;
    view.AllowNew = true;
    view.RowFilter = "City = 'Berlin'";
    view.RowStateFilter = DataViewRowState.ModifiedCurrent;
    view.Sort = "CompanyName DESC";

    // Simple-bind to a TextBox control
    Text1.DataBindings.Add("Text", view, "CompanyName");
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

DataView-Klasse
DataView-Member
System.Data-Namespace
DataColumn.Expression-Eigenschaft
Sort

Freigeben über