MessageFilterTable<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 o el mensaje almacenado en búfer especificado satisface los criterios de coincidencia de exactamente un MessageFilter de la tabla, y agrega los datos del filtro correspondiente a una colección.
Sobrecargas
GetMatchingValue(Message, TFilterData) |
Devuelve un valor que indica si el mensaje almacenado en búfer especificado satisface los criterios de coincidencia de exactamente un MessageFilter de la tabla, y agrega los datos del filtro coincidentes a una colección. |
GetMatchingValue(MessageBuffer, TFilterData) |
Devuelve un valor que indica si el mensaje almacenado en búfer especificado satisface los criterios de coincidencia de exactamente un filtro de la tabla y agrega los datos del filtro coincidentes a una colección. |
Comentarios
Utilice uno de estos métodos cuando se espere que un único filtro coincida con el mensaje y sólo se deban recuperar los FilterData
del filtro correspondiente.
Utilice GetMatchingValue para inspeccionar encabezados del mensaje y GetMatchingValue para inspeccionar un mensaje almacenado en búfer, lo que puede incluir examinar el cuerpo del mensaje.
GetMatchingValue(Message, TFilterData)
Devuelve un valor que indica si el mensaje almacenado en búfer especificado satisface los criterios de coincidencia de exactamente un MessageFilter de la tabla, y agrega los datos del filtro coincidentes a una colección.
public:
virtual bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % data);
public bool GetMatchingValue (System.ServiceModel.Channels.Message message, out TFilterData data);
abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool
Public Function GetMatchingValue (message As Message, ByRef data As TFilterData) As Boolean
Parámetros
- data
- TFilterData
Parámetro out
que almacena el valor FilterData
que coincide con message
.
Devoluciones
true
si el mensaje satisface los criterios de coincidencia de un filtro de la tabla; false
si no se cumple ningún filtro.
Implementaciones
Excepciones
Más de un filtro coincide con el message
.
Un filtro intentó examinar el contenido del cuerpo del mensaje.
Comentarios
Utilice este método cuando se espere que un único filtro coincida con el mensaje y sólo se deban recuperar los FilterData
del filtro correspondiente.
Este método implementa GetMatchingFilter.
Se aplica a
GetMatchingValue(MessageBuffer, TFilterData)
Devuelve un valor que indica si el mensaje almacenado en búfer especificado satisface los criterios de coincidencia de exactamente un filtro de la tabla y agrega los datos del filtro coincidentes a una colección.
public:
virtual bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ buffer, [Runtime::InteropServices::Out] TFilterData % data);
public bool GetMatchingValue (System.ServiceModel.Channels.MessageBuffer buffer, out TFilterData data);
abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
Public Function GetMatchingValue (buffer As MessageBuffer, ByRef data As TFilterData) As Boolean
Parámetros
- buffer
- MessageBuffer
MessageBuffer que se va a probar.
- data
- TFilterData
Parámetro out
que almacena el valor FilterData
que coincide con buffer
.
Devoluciones
true
si el mensaje almacenado en búfer satisface los criterios de coincidencia de un filtro de la tabla; false
si no se cumple ningún filtro.
Implementaciones
Excepciones
Más de un filtro coincide con el messageBuffer
.
Comentarios
Utilice este método cuando se espera que un único filtro coincida con el mensaje almacenado en búfer y sólo se deban recuperar los FilterData
del filtro correspondiente. Dado el filtro coincide con un mensaje almacenado en búfer, puede especificar las condiciones en el cuerpo del mensaje.
Este método implementa GetMatchingFilter.