IWMPQuery::addCondition-Methode
Die addCondition-Methode fügt der Verbundabfrage mithilfe der AND-Logik eine Bedingung hinzu.
Syntax
public void addCondition(
System.String bstrAttribute,
System.String bstrOperator,
System.String bstrValue
);
Public Sub addCondition( _
ByVal bstrAttribute As System.String, _
ByVal bstrOperator As System.String, _
ByVal bstrValue As System.String _
)
Implements IWMPQuery.addCondition
Parameter
-
bstrAttribute [ In]
-
Eine System.String, die der Name des Attributs ist, das der Abfrage hinzugefügt werden soll.
-
bstrOperator [ In]
-
Eine System.String,die der Operator ist. Unterstützte Werte finden Sie unter Hinweise.
-
bstrValue [ In]
-
Eine System.String,die der Attributwert ist.
Rückgabewert
Diese Methode gibt keinen Wert zurück.
Bemerkungen
In einer Verbundabfrage enthaltene Bedingungen werden in Bedingungsgruppen organisiert. Mehrere Bedingungen innerhalb einer Bedingungsgruppe werden immer mithilfe von AND-Logik verkettet. Bedingungsgruppen werden immer mithilfe von OR-Logik miteinander verkettet. Um eine neue Bedingungsgruppe zu starten, rufen Sie IWMPQuery.beginNextGroup auf.
Bei zusammengesetzten Abfragen, die IWMPQuery verwenden, wird die Groß-/Kleinschreibung nicht beachtet.
Eine Liste der Werte für den bstrAttribute-Parameter finden Sie unter Alphabetischer Attributverweis.
In der folgenden Tabelle sind die unterstützten Werte für bstrOperator aufgeführt.
| String | Gilt für: |
|---|---|
| BeginsWith | Zeichenfolgen |
| Enthält | Zeichenfolgen |
| Equals | Alle Typen |
| GreaterThan | Zahlen, Datumsangaben |
| Größer als oder gleich | Zahlen, Datumsangaben |
| LessThan | Zahlen, Datumsangaben |
| Kleiner als oder gleich | Zahlen, Datumsangaben |
| NotBeginsWith | Zeichenfolgen |
| NotContains | Zeichenfolgen |
| NotEquals | Alle Typen |
Beispiele
Im folgenden Beispiel wird eine Abfrage erstellt, zwei Bedingungen hinzugefügt und diese Abfrage verwendet, um die Ergebnisse der Abfrage als Zeichenfolgenauflistung zu extrahieren. Die Ergebnisse werden dann in einem Listenfeld angezeigt. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable player dargestellt.
// Get a new Query interface.
WMPLib.IWMPMediaCollection2 mc = (WMPLib.IWMPMediaCollection2)player.mediaCollection;
WMPLib.IWMPQuery q = mc.createQuery();
// Add two conditions to the Query.
q.addCondition("WM/Composer", "Equals", "Antonio Vivaldi");
q.addCondition("Title", "Contains", "Trio");
// Query the media collection and get a string collection containing the result.
// In this case, the string collection will contain the titles of all audio items that
// match the query.
WMPLib.IWMPStringCollection2 result = (WMPLib.IWMPStringCollection2)mc.getStringCollectionByQuery("Title", q, "audio", "", false);
// Display the results by adding them to a list box.
for (int i = 0; i < result.count; i++)
{
queryResults.Items.Add(result.Item(i));
}
' Get a new Query interface.
Dim mc As WMPLib.IWMPMediaCollection2 = player.mediaCollection
Dim q As WMPLib.IWMPQuery = mc.createQuery()
' Add two conditions to the Query.
q.addCondition("WM/Composer", "Equals", "Antonio Vivaldi")
q.addCondition("Title", "Contains", "Trio")
' Query the media collection and get a string collection containing the result.
' In this case, the string collection will contain the titles of all audio items that
' match the query.
Dim result As WMPLib.IWMPStringCollection2 = mc.getStringCollectionByQuery("Title", q, "audio", "", False)
' Display the results by adding them to a list box.
For i As Integer = 0 To (result.count - 1)
queryResults.Items.Add(result.Item(i))
Next i
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Version |
Windows Media Player 11. |
| Namespace |
WMPLib |
| Assembly |
|