ServiceBehaviorAttribute.IgnoreExtensionDataObject Özellik

Tanım

Ad Alanı:

System.ServiceModel

Bütünleştirilmiş Kod:

System.ServiceModel.dll

Kabloya bilinmeyen serileştirme verilerinin gönderilip gönderilmeymeyeceğini belirten bir değer alır veya ayarlar.

public:
 property bool IgnoreExtensionDataObject { bool get(); void set(bool value); };

public bool IgnoreExtensionDataObject { get; set; }

member this.IgnoreExtensionDataObject : bool with get, set

Public Property IgnoreExtensionDataObject As Boolean

Özellik Değeri

Boolean

true bilinmeyen serileştirme verileri hiçbir zaman gönderilmezse; aksi takdirde , false. Varsayılan değer: false.

Örnekler

Aşağıdaki örnekte ve uygulamasının IgnoreExtensionDataObject kullanımı gösterilmektedir IExtensibleDataObject. Bu örnekte, olarak ayarlandığındafalse, IgnoreExtensionDataObject istemcinin bildiği ek veriler istemciye geri yuvarlanmış durumdadır.

using System;
using System.Collections.Generic;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.Text;
using System.Xml;

namespace Microsoft.WCF.Documentation
{
  [ServiceContract(Namespace = "http://microsoft.wcf.documentation")]
  public interface ISampleService{
    [OperationContract]
    Person SampleMethod(Person personParam);
  }

  [DataContract(Name="OriginalPerson", Namespace="http://microsoft.wcf.documentation")]
  public class Person : IExtensibleDataObject
  {
    [DataMember]
    public string firstName;
    [DataMember]
    public string lastName;
    [DataMember]
    public string Message;
    [DataMember]
    public XmlNode[] Blob;

    #region IExtensibleDataObject Members
    private ExtensionDataObject data = null;

    public ExtensionDataObject ExtensionData
    {
      get
      {
        return this.data;
      }
      set
      {
        this.data = value;
      }
    }
    #endregion
  }

  [ServiceBehaviorAttribute(
    IgnoreExtensionDataObject=false,
    ValidateMustUnderstand=false
  )]
  class SampleService : ISampleService
  {
  #region ISampleService Members
    public Person SampleMethod(Person msg)
    {
      Console.WriteLine(msg.firstName);
      Console.WriteLine(msg.lastName);
      Console.WriteLine(msg.Message);

      msg.lastName = "First Name";
      msg.firstName = "Last Name";
      msg.Message = "This is the Reply message.";
        return msg;
    }
  #endregion
  }
}

Açıklamalar

Bir tür arabirimi uygularsa IExtensibleDataObject , bu tür seri durumdan çıkarılırken kablo üzerinden gelen hakkında bilmediği ek verileri depolar. Örneğin, bir tür Person ve üyelerine FirstName LastNamesahipse ve adlı PhoneNumber bir öğe gelirse depolanır. Daha sonra türü seri hale getirildiğinde, PhoneNumber yeniden gönderilir. Sorun, bu hizmet tarafından dışarı aktarılan şemada Person yalnızca ve LastNameolmasıdırFirstName, bu nedenle Windows Communication Foundation (WCF) şema geçersiz bir örnek oluşturur! Sıkı şema uyumluluğu önemliyse, bu yeniden yayma davranışını kapatmak için olarak ayarlayabilirsiniz IgnoreExtensionDataObject true .

Ayarı ne olursa olsun IgnoreExtensionDataObject , WCF her zaman bilinen verileri (hem içeri hem de dışarı) işler ve fazladan veri geldiğinde özel durumlar oluşturmaz. Bu özelliği bir uygulama yapılandırma dosyasındaki <dataContractSerializer> öğesini kullanarak da ayarlayabilirsiniz.