IMessageFilterTable<TFilterData>.GetMatchingValue Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve un valor que indica si el mensaje especificado o el mensaje almacenado en búfer satisface el criterio de coincidencia de un filtro de la tabla y devuelve los datos de filtro para el filtro que coincide.
Sobrecargas
| Nombre | Description |
|---|---|
| GetMatchingValue(Message, TFilterData) |
Devuelve un valor que indica si el mensaje especificado satisface exactamente el criterio de coincidencia de un filtro de la tabla y agrega los datos de filtro coincidentes a una colección. |
| GetMatchingValue(MessageBuffer, TFilterData) |
Devuelve un valor que indica si el mensaje almacenado en búfer especificado satisface exactamente el criterio de coincidencia de un filtro de la tabla y agrega los datos de filtro coincidentes a una colección. |
Comentarios
Use uno de estos métodos cuando, como máximo, se espera que un filtro coincida con el mensaje y solo se deben recuperar los datos de filtro del filtro coincidente. Estos métodos devuelven un valor booleano que indica si se encontró un filtro coincidente y establecen el parámetro de referencia en los datos de data filtro coincidentes.
Use GetMatchingFilter si el cuerpo del mensaje no lo inspecciona ninguno de los filtros de la tabla de filtros.
Si un filtro puede inspeccionar el cuerpo del mensaje en la tabla de filtros, almacene en búfer el mensaje y páselo a la GetMatchingFilter versión del método .
GetMatchingValue(Message, TFilterData)
- Source:
- IMessageFilterTable.cs
- Source:
- IMessageFilterTable.cs
- Source:
- IMessageFilterTable.cs
Devuelve un valor que indica si el mensaje especificado satisface exactamente el criterio de coincidencia de un filtro de la tabla y agrega los datos de filtro coincidentes a una colección.
public:
bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % value);public bool GetMatchingValue(System.ServiceModel.Channels.Message message, out TFilterData value);abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> boolPublic Function GetMatchingValue (message As Message, ByRef value As TFilterData) As BooleanParámetros
- value
- TFilterData
outparámetro que almacena el FilterData objeto que coincide con .message
Devoluciones
true si el mensaje cumple exactamente el criterio de coincidencia de un filtro de la tabla; false si no se cumple ningún filtro.
Comentarios
Use este método cuando se espera que un solo filtro coincida con el mensaje y solo se deben recuperar los datos de filtro del filtro coincidente.
Este método espera como máximo un único filtro coincidente. Si hay más de una coincidencia de filtro, se debe producir una MultipleFilterMatchesException excepción .
Si un filtro debe inspeccionar el cuerpo del mensaje en la tabla de filtros, almacene en búfer el mensaje utilizando CreateBufferedCopy y páselo a la GetMatchingValue versión del método .
Notas a los implementadores
Si más de un filtro coincide con el mensaje, se debe iniciar una MultipleFilterMatchesException excepción .
Esta sobrecarga toma y Message debe iniciar un InvalidBodyAccessException si intenta examinar el cuerpo del mensaje.
Se aplica a
GetMatchingValue(MessageBuffer, TFilterData)
- Source:
- IMessageFilterTable.cs
- Source:
- IMessageFilterTable.cs
- Source:
- IMessageFilterTable.cs
Devuelve un valor que indica si el mensaje almacenado en búfer especificado satisface exactamente el criterio de coincidencia de un filtro de la tabla y agrega los datos de filtro coincidentes a una colección.
public:
bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] TFilterData % value);public bool GetMatchingValue(System.ServiceModel.Channels.MessageBuffer messageBuffer, out TFilterData value);abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> boolPublic Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef value As TFilterData) As BooleanParámetros
- messageBuffer
- MessageBuffer
que MessageBuffer se va a probar.
- value
- TFilterData
outparámetro que almacena el FilterData objeto que coincide con .messageBuffer
Devoluciones
true si el mensaje cumple exactamente el criterio de coincidencia de un filtro de la tabla; false si no se cumple ningún filtro.
Comentarios
Use este método cuando se espera que un único filtro coincida con el mensaje almacenado en búfer, solo se deben recuperar los datos de filtro del filtro coincidente y es posible que sea necesario inspeccionar el cuerpo del mensaje.
Notas a los implementadores
Si más de un filtro coincide con el mensaje, se debe iniciar una MultipleFilterMatchesException excepción .
