XmlMessageFormatter.CanRead(Message) Método

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Determina se o formatador pode desserializar a mensagem.

public:
 virtual bool CanRead(System::Messaging::Message ^ message);

public bool CanRead (System.Messaging.Message message);

abstract member CanRead : System.Messaging.Message -> bool
override this.CanRead : System.Messaging.Message -> bool

Public Function CanRead (message As Message) As Boolean

Parâmetros

message

Message

O Message a ser inspecionado.

Retornos

Boolean

true se o formatador XML puder desserializar a mensagem; caso contrário, false.

Implementações

CanRead(Message)

Exceções

InvalidOperationException

Nenhuma das propriedades TargetTypeNames ou TargetTypes foi definida.

ArgumentNullException

O parâmetro message é null.

Comentários

Quando CanRead é chamado, o formatador tenta determinar se o conteúdo da mensagem é algo que pode desserializar. O formatador só poderá desserializar a mensagem se o tipo no corpo da mensagem tiver o mesmo esquema que um dos tipos na matriz representada pelas TargetTypeNames propriedades e TargetTypes . CanRead retorna false sob as duas circunstâncias a seguir:

• A mensagem não foi formatada usando o XmlMessageFormatter.

• O esquema do corpo da mensagem não está entre os listados na TargetTypeNames propriedade ou TargetTypes .

As TargetTypeNames propriedades e TargetTypes informam ao formatador quais tipos de objetos ele deve ser capaz de desserializar. Se algum tipo estiver ausente na lista, ainda será encontrado dentro da mensagem, CanRead retornará false.

Confira também

• TargetTypes
• TargetTypeNames
• BinaryMessageFormatter
• ActiveXMessageFormatter