다음을 통해 공유


IMessageFilterTable<TFilterData>.GetMatchingFilter 메서드

정의

테이블에서 지정된 메시지 또는 버퍼링된 메시지가 쿼리 조건을 충족하는 필터를 반환합니다.

오버로드

GetMatchingFilter(Message, MessageFilter)

지정된 메시지가 테이블에서 정확히 한 필터의 일치 조건을 충족하는지 여부를 나타내는 값을 반환하고 out 매개 변수에 해당 필터를 반환합니다.

GetMatchingFilter(MessageBuffer, MessageFilter)

지정된 메시지 또는 버퍼링된 메시지가 테이블에서 정확히 한 필터의 일치 조건을 충족하는지 여부를 나타내는 값을 반환하고 out 매개 변수에 해당 필터를 반환합니다.

설명

메시지와 일치하는 필터가 한 개로 예상되고 일치하는 필터가 필수적 요소인 경우 이 메서드를 사용합니다.

본문 내용을 검사할 필요가 없으면 GetMatchingFilter를 사용합니다. 메시지 본문 내용을 검사해야 하면 GetMatchingFilter를 사용합니다.

GetMatchingFilter(Message, MessageFilter)

Source:
IMessageFilterTable.cs
Source:
IMessageFilterTable.cs

지정된 메시지가 테이블에서 정확히 한 필터의 일치 조건을 충족하는지 여부를 나타내는 값을 반환하고 out 매개 변수에 해당 필터를 반환합니다.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);
public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter filter);
abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool
Public Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As Boolean

매개 변수

message
Message

테스트할 Message입니다.

filter
MessageFilter

message가 충족하는 필터를 저장하는 out 매개 변수입니다. 필터가 없을 경우 이 매개 변수는 기본값으로 설정됩니다.

반환

message가 테이블에 있는 필터 중 적어도 하나의 일치 조건을 충족하면 true이고 조건을 충족하는 필터가 없으면 false입니다.

설명

메시지와 일치하는 필터가 한 개로 예상되고 일치하는 필터가 필수적 요소인 경우 이 메서드를 사용합니다.

필터 테이블의 필터에서 메시지 본문을 검사해야 하는 경우 메서드의 버전을 사용합니다 GetMatchingFilter .

구현자 참고

둘 이상의 필터가 메시지와 일치하는 경우 을 MultipleFilterMatchesException throw해야 합니다.

이 버전은 을 Message 사용하고 메시지 본문을 검사하려는 경우 을 throw InvalidBodyAccessException 해야 합니다.

적용 대상

GetMatchingFilter(MessageBuffer, MessageFilter)

Source:
IMessageFilterTable.cs
Source:
IMessageFilterTable.cs

지정된 메시지 또는 버퍼링된 메시지가 테이블에서 정확히 한 필터의 일치 조건을 충족하는지 여부를 나타내는 값을 반환하고 out 매개 변수에 해당 필터를 반환합니다.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);
public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer messageBuffer, out System.ServiceModel.Dispatcher.MessageFilter filter);
abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool
Public Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As Boolean

매개 변수

messageBuffer
MessageBuffer

테스트할 MessageBuffer입니다.

filter
MessageFilter

message가 충족하는 필터를 저장하는 out 매개 변수입니다. 필터가 없을 경우 이 매개 변수는 기본값으로 설정됩니다.

반환

messageBuffer가 테이블에 있는 필터 중 적어도 하나의 일치 조건을 충족하면 true이고 조건을 충족하는 필터가 없으면 false입니다.

설명

단일 필터가 버퍼링된 메시지와 일치해야 하고, 일치하는 필터가 반환되어야 하며, 메시지 본문을 검사해야 할 때 이 메서드를 사용합니다.

적용 대상