XPathMessageFilter Třída

Definice

Obor názvů:

System.ServiceModel.Dispatcher

Sestavení:

System.ServiceModel.dll

Představuje dotaz na dokument XML definovaný výrazem XPath 1.0.

public ref class XPathMessageFilter : System::ServiceModel::Dispatcher::MessageFilter, System::Xml::Serialization::IXmlSerializable

public class XPathMessageFilter : System.ServiceModel.Dispatcher.MessageFilter, System.Xml.Serialization.IXmlSerializable

type XPathMessageFilter = class
    inherit MessageFilter
    interface IXmlSerializable

Public Class XPathMessageFilter
Inherits MessageFilter
Implements IXmlSerializable

Dědičnost

Object

MessageFilter

XPathMessageFilter

Implementuje

IXmlSerializable

Poznámky

Používá XPathMessageFilter výraz XPath k určení, zda dokument XML obsahuje určité prvky, atributy, text nebo jiné syntaktické konstrukce XML. Aplikace obvykle používá XPathMessageFilter na koncovém bodu dotaz na obsah zprávy SOAP a pak na základě výsledků tohoto dotazu provede příslušnou akci. Proces řazení do fronty může například použít dotaz XPath ke kontrole prvku priority známé hlavičky, aby se rozhodl, zda se má zpráva přesunout na frontu fronty.

Jazyk XPath (XML Path Language) poskytuje jazyk pro adresování částí dokumentu XML. Primární syntaktický konstruktor v XPath je výraz, který definuje, jak procházet logickou strukturu dokumentu XML a adresovat nebo identifikovat datový typ XPath. Konkrétně implementace XPath vyhodnocují výraz proti struktuře dokumentu XML a poskytují jeden ze čtyř základních datových typů XPath: řetězce, čísla, logické hodnoty a sady uzlů. Podporují také funkce, které převádějí datový typ XPath na datový typ řetězec, číslo nebo logický typ. Pokud metoda očekává jeden z těchto tří datových typů, výsledek vyhodnocení výrazu se implicitně převede. Všimněte si, že tyto tři datové typy nelze převést na typ sady uzlů. Jazyk CESTY XML je plně popsán ve specifikaci W3C XML Path Language 1.0.

Čísla ve výrazech XPath jsou vyjádřena jako 64bitové hodnoty s dvojitou přesností. Proto výrazy XPath, které zahrnují testování čísel s mnoha významnými číslicemi, mohou vracet nesprávné výsledky kvůli problémům s přesností s plovoucí desetinou čárkou. Další informace najdete v tématu XML Path Language (XPath) verze 1.0, oddíl 3.5.

Konstruktory

XPathMessageFilter()	Inicializuje novou instanci XPathMessageFilter třídy, která odpovídá všem dokumentům XML ve správném formátu.
XPathMessageFilter(String)	Inicializuje novou instanci XPathMessageFilter třídy pomocí výrazu XPath k určení kritérií dotazu pro filtr.
XPathMessageFilter(String, XmlNamespaceManager)	Inicializuje novou instanci XPathMessageFilter třídy pomocí zadaného výrazu XPath a správce oboru názvů.
XPathMessageFilter(String, XsltContext)	Inicializuje novou instanci třídy pomocí zadaného XPathMessageFilter výrazu XPath a XsltContext.
XPathMessageFilter(XmlReader)	Inicializuje novou instanci XPathMessageFilter třídy čtením streamovaného XPath se zadaným čtečkou XML.
XPathMessageFilter(XmlReader, XmlNamespaceManager)	Inicializuje novou instanci XPathMessageFilter třídy čtením v streamované XPath se zadaným čtečkou XML a pomocí zadaného správce oboru názvů.
XPathMessageFilter(XmlReader, XsltContext)	Inicializuje novou instanci XPathMessageFilter třídy čtením streamovaného XPath se zadaným čtečkou XML a pomocí k XsltContext překladu oborů názvů, vlastních funkcí a proměnných.

Vlastnosti

Namespaces	Získá správce, který překládá předpony oboru názvů ve výrazu XPath, který definuje filtr.
NodeQuota	Získá nebo nastaví maximální počet uzlů, které by měly být při vyhodnocování filtru zhlédnou.
XPath	Získá výraz XPath, který definuje kritéria dotazu pro filtr.

Metody

CreateFilterTable<FilterData>()	Vytvoří, XPathMessageFilterTable<TFilterData> který má přiřazený zadaný typ dat.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
Match(Message)	Testuje, zda zadaná zpráva splňuje kritéria filtru XPath. Tento formulář nemá přístup k textu zprávy.
Match(MessageBuffer)	Určuje, zda zpráva ve vyrovnávací paměti splňuje kritéria dotazu filtru XPath.
Match(SeekableXPathNavigator)	Určuje, zda dokument XML poskytnutý zadaný optimalizovaný navigátor XPath splňuje kritéria dotazu filtru XPath.
Match(XPathNavigator)	Vyhodnotí filtr zadaného navigátoru XPath.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnGetSchema()	Získá schéma pro aktuální dokument XML.
OnReadXml(XmlReader)	Načte aktuální uzel XML.
OnWriteXml(XmlWriter)	Zapíše uzel pomocí writer.
ReadXPath(XmlReader, XmlNamespaceManager)	Inicializuje aktuální instanci XPathMessageFilter pomocí XPath získané ze zadaného čtenáře XML pomocí zadaného správce oboru názvů.
StaticGetSchema(XmlSchemaSet)	Získá typ schématu XML slouží k serializaci filtru XPath.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrimToSize()	Zkomprimuje filtr XPath, který uvolní veškerou nevyužitou paměť.
WriteXPath(XmlWriter, IXmlNamespaceResolver)	Serializuje filtr XPath na XmlWriter.
WriteXPathTo(XmlWriter, String, String, String, Boolean)	Zapíše XML XPath element se zadaným zapisovačem XML.

Explicitní implementace rozhraní

IXmlSerializable.GetSchema()	Explicitní implementace rozhraní, která získá aktuální schéma.
IXmlSerializable.ReadXml(XmlReader)	Explicitní implementace rozhraní, která čte aktuální uzel XML.
IXmlSerializable.WriteXml(XmlWriter)	Explicitní implementace rozhraní, která zapisuje uzel XML pomocí writer.