DataContractResolver DataContractResolver DataContractResolver DataContractResolver Class

定義

シリアル化および逆シリアル化の際に型と xsi:type 表現との間の動的なマッピングを行う機構を提供します。Provides a mechanism for dynamically mapping types to and from xsi:type representations during serialization and deserialization.

public ref class DataContractResolver abstract
public abstract class DataContractResolver
type DataContractResolver = class
Public MustInherit Class DataContractResolver
継承
DataContractResolverDataContractResolverDataContractResolverDataContractResolver
派生

次の例では、DataContractResolver からクラスを派生させる方法を示します。The following example shows how to derive a class from DataContractResolver. 実際のサンプルについては、「 DataContractResolver」を参照してください。For a working sample, see DataContractResolver.

class MyDataContractResolver : DataContractResolver
{
    private Dictionary<string, XmlDictionaryString> dictionary = new Dictionary<string, XmlDictionaryString>();
    Assembly assembly;

    // Definition of the DataContractResolver
    public MyDataContractResolver(Assembly assembly)
    {
        this.assembly = assembly;
    }

    // Used at deserialization
    // Allows users to map xsi:type name to any Type 
    public override Type ResolveName(string typeName, string typeNamespace, Type declaredType, DataContractResolver knownTypeResolver)
    {
        XmlDictionaryString tName;
        XmlDictionaryString tNamespace;
        if (dictionary.TryGetValue(typeName, out tName) && dictionary.TryGetValue(typeNamespace, out tNamespace))
        {
            return this.assembly.GetType(tNamespace.Value + "." + tName.Value);
        }
        else
        {
            return null;
        }
    }
    // Used at serialization
    // Maps any Type to a new xsi:type representation
    public override bool TryResolveType(Type type, Type declaredType, DataContractResolver knownTypeResolver, out XmlDictionaryString typeName, out XmlDictionaryString typeNamespace)
    {
        string name = type.Name;
        string namesp = type.Namespace;
        typeName = new XmlDictionaryString(XmlDictionary.Empty, name, 0); 
        typeNamespace = new XmlDictionaryString(XmlDictionary.Empty, namesp, 0);
        if (!dictionary.ContainsKey(type.Name))
        {
            dictionary.Add(name, typeName);
        }
        if (!dictionary.ContainsKey(type.Namespace))
        {
            dictionary.Add(namesp, typeNamespace);
        }
        return true;
    }
}

注釈

ネットワーク経由で送信されるデータについては、開発者に注意する必要があります。Developers should be careful about what data is being sent over the wire. トランスポートまたはメッセージセキュリティを使用して、そのデータをセキュリティで保護することができます。You can use transport or message security to secure that data. 詳細については、セキュリティに関するページをご覧ください。For more information, see Security.

警告

シリアル化DataContractResolverされている情報が完全にわかっている場合にのみ、を使用します。Only use DataContractResolver if you are completely sure of what information is being serialized. 悪意のある型が予期しない動作をする可能性があります。Malicious types can cause unexpected behavior.

コンストラクター

DataContractResolver() DataContractResolver() DataContractResolver() DataContractResolver()

DataContractResolver クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataContractResolver class.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ResolveName(String, String, Type, DataContractResolver) ResolveName(String, String, Type, DataContractResolver) ResolveName(String, String, Type, DataContractResolver) ResolveName(String, String, Type, DataContractResolver)

このメソッドをオーバーライドして、逆シリアル化中に指定された xsi:type 名と名前空間をデータ コントラクト型にマップします。Override this method to map the specified xsi:type name and namespace to a data contract type during deserialization.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
TryResolveType(Type, Type, DataContractResolver, XmlDictionaryString, XmlDictionaryString) TryResolveType(Type, Type, DataContractResolver, XmlDictionaryString, XmlDictionaryString) TryResolveType(Type, Type, DataContractResolver, XmlDictionaryString, XmlDictionaryString) TryResolveType(Type, Type, DataContractResolver, XmlDictionaryString, XmlDictionaryString)

このメソッドをオーバーライドして、シリアル化中にデータ コントラクト型を xsi:type 名と名前空間にマップします。Override this method to map a data contract type to an xsi:type name and namespace during serialization.

適用対象