NetDataContractSerializer コンストラクター

リファレンス

定義

名前空間:: System.Runtime.Serialization

アセンブリ:: System.Runtime.Serialization.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

NetDataContractSerializer クラスの新しいインスタンスを初期化します。

オーバーロード

NetDataContractSerializer()	NetDataContractSerializer クラスの新しいインスタンスを初期化します。
NetDataContractSerializer(StreamingContext)	指定したストリーミングコンテキストデータを使用して、NetDataContractSerializer クラスの新しいインスタンスを初期化します。
NetDataContractSerializer(String, String)	指定した XML ルート要素と名前空間を指定して、NetDataContractSerializer クラスの新しいインスタンスを初期化します。
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)	コンテンツを指定するために使用されるルート要素と名前空間を含む NetDataContractSerializer 型の 2 つのパラメーターを使用して、XmlDictionaryString クラスの新しいインスタンスを初期化します。
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	コンテキストデータ、シリアル化されるオブジェクト内の項目の最大数、追加データを無視するかどうかを指定するパラメーター、アセンブリを読み込むメソッドを指定するパラメーター、サロゲートセレクターを指定するパラメーターを使用して、NetDataContractSerializer クラスの新しいインスタンスを初期化します。
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	コンテキストデータ、ルート名、シリアル化されるオブジェクト内の項目の最大数、追加データを無視するかどうかを指定するパラメーター、アセンブリを読み込むメソッドを指定するパラメーター、およびサロゲートセレクターを指定するパラメーターを使用して、NetDataContractSerializer クラスの新しいインスタンスを初期化します。
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	コンテキストデータ、ルート名、名前空間 (XmlDictionaryString パラメーターとして指定)、シリアル化されるオブジェクト内の項目の最大数、追加データを無視するかどうかを指定するパラメーター、アセンブリを読み込むメソッドを指定するパラメーター、サロゲートセレクターを指定するパラメーターを使用して、NetDataContractSerializer クラスの新しいインスタンスを初期化します。

NetDataContractSerializer()

NetDataContractSerializer クラスの新しいインスタンスを初期化します。

public:
 NetDataContractSerializer();

public NetDataContractSerializer ();

Public Sub New ()

例

public static void Constructor1()
{
    // Create an instance of the NetDataContractSerializer.
    NetDataContractSerializer ser =
        new NetDataContractSerializer();
    // Other code not shown.
}

Public Shared Sub Constructor1() 
    ' Create an instance of the NetDataContractSerializer.
    Dim ser As New System.Runtime.Serialization.NetDataContractSerializer()

End Sub 

' Other code not shown.

適用対象

NetDataContractSerializer(StreamingContext)

指定したストリーミングコンテキストデータを使用して、NetDataContractSerializer クラスの新しいインスタンスを初期化します。

public:
 NetDataContractSerializer(System::Runtime::Serialization::StreamingContext context);

public NetDataContractSerializer (System.Runtime.Serialization.StreamingContext context);

new System.Runtime.Serialization.NetDataContractSerializer : System.Runtime.Serialization.StreamingContext -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (context As StreamingContext)

パラメーター

context: StreamingContext

コンテキストデータを含む StreamingContext。

例

次の例では、NetDataContractSerializer を使用して、StreamingContext のインスタンスを作成しています。

public static void Constructor2()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);
    // Create a DatatContractSerializer with the collection.
    NetDataContractSerializer ser2 = new NetDataContractSerializer(sc);

    // Other code not shown.
}

Public Shared Sub Constructor2() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    ' Create a DatatContractSerializer with the collection.
    Dim ser2 As New System.Runtime.Serialization.NetDataContractSerializer(sc)

   ' Other code not shown.
End Sub

注釈

StreamingContext クラスを使用して、オブジェクトの読み取りと書き込み中に使用する、ユーザー固有のコンテキストデータを渡すことができます。

適用対象

NetDataContractSerializer(String, String)

指定した XML ルート要素と名前空間を指定して、NetDataContractSerializer クラスの新しいインスタンスを初期化します。

public:
 NetDataContractSerializer(System::String ^ rootName, System::String ^ rootNamespace);

public NetDataContractSerializer (string rootName, string rootNamespace);

new System.Runtime.Serialization.NetDataContractSerializer : string * string -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (rootName As String, rootNamespace As String)

パラメーター

rootName: String

シリアル化または逆シリアル化するコンテンツを囲む XML 要素の名前。

rootNamespace: String

シリアル化または逆シリアル化するコンテンツを囲む XML 要素の名前空間。

例

オブジェクトを逆シリアル化するときに予想する XML ルート要素と名前空間を指定して、DataContractSerializer のインスタンスを作成する例を次に示します。

public static void Constructor3()
{
    // Create an instance of the NetDataContractSerializer
    // specifying the name and namespace as strings.
    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        "Customer",
        "http://www.contoso.com");
    // Other code not shown.
}

Public Shared Sub Constructor3() 
    ' Create an instance of the NetDataContractSerializer
    ' specifying the name and namespace as strings.
    Dim ser As New System.Runtime.Serialization. _
       NetDataContractSerializer("Customer", "http://www.contoso.com")

   ' Other code not shown.

End Sub

適用対象

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

コンテンツを指定するために使用されるルート要素と名前空間を含む NetDataContractSerializer 型の 2 つのパラメーターを使用して、XmlDictionaryString クラスの新しいインスタンスを初期化します。

public:
 NetDataContractSerializer(System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace);

public NetDataContractSerializer (System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace);

new System.Runtime.Serialization.NetDataContractSerializer : System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString)

パラメーター

rootName: XmlDictionaryString

シリアル化または逆シリアル化するコンテンツを囲む XML 要素の名前を含む XmlDictionaryString。

rootNamespace: XmlDictionaryString

シリアル化または逆シリアル化するコンテンツを囲む XML 要素の名前空間を含む XmlDictionaryString。

例

オブジェクトを逆シリアル化するときに予想する XML ルート要素と名前空間を (DataContractSerializer 引数として) 指定して、XmlDictionaryString のインスタンスを作成する例を次に示します。

public static void Constructor4()
{
    // Create an XmlDictionary and add values to it.
    XmlDictionary d = new XmlDictionary();
    // Initialize the out variables.
    XmlDictionaryString name_value = d.Add("Customer");
    XmlDictionaryString ns_value = d.Add("http://www.contoso.com");

    // Create the serializer.
    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        name_value,
        ns_value);
    // Other code not shown.
}

 Public Shared Sub Constructor4() 
     ' Create an XmlDictionary and add values to it.
     Dim d As New XmlDictionary()
     Dim name_value As XmlDictionaryString =d.Add("Customer")
     Dim ns_value As XmlDictionaryString = d.Add("http://www.contoso.com")
     
     ' Create the serializer.
     Dim ser As New System.Runtime.Serialization. _
        NetDataContractSerializer(name_value, ns_value)

     ' Other code not shown.
 
 End Sub

注釈

オブジェクトインスタンス間で同じ文字列のセットが使用される場合は、XmlDictionaryString を使用してパフォーマンスを最適化できます。

適用対象

NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

コンテキストデータ、シリアル化されるオブジェクト内の項目の最大数、追加データを無視するかどうかを指定するパラメーター、アセンブリを読み込むメソッドを指定するパラメーター、サロゲートセレクターを指定するパラメーターを使用して、NetDataContractSerializer クラスの新しいインスタンスを初期化します。

public:
 NetDataContractSerializer(System::Runtime::Serialization::StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System::Runtime::Serialization::Formatters::FormatterAssemblyStyle assemblyFormat, System::Runtime::Serialization::ISurrogateSelector ^ surrogateSelector);

public NetDataContractSerializer (System.Runtime.Serialization.StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System.Runtime.Serialization.Formatters.FormatterAssemblyStyle assemblyFormat, System.Runtime.Serialization.ISurrogateSelector surrogateSelector);

new System.Runtime.Serialization.NetDataContractSerializer : System.Runtime.Serialization.StreamingContext * int * bool * System.Runtime.Serialization.Formatters.FormatterAssemblyStyle * System.Runtime.Serialization.ISurrogateSelector -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (context As StreamingContext, maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, assemblyFormat As FormatterAssemblyStyle, surrogateSelector As ISurrogateSelector)

パラメーター

context: StreamingContext

コンテキストデータを含む StreamingContext。

maxItemsInObjectGraph: Int32

シリアル化または逆シリアル化するグラフ内の項目の最大数。

ignoreExtensionDataObject: Boolean

種類の拡張機能により提供されるデータを無視する場合は true。それ以外の場合は false。

assemblyFormat: FormatterAssemblyStyle

アセンブリの検索および読み込みをするメソッドを指定する FormatterAssemblyStyle 値。

surrogateSelector: ISurrogateSelector

ISurrogateSelector の実装。

例外

ArgumentOutOfRangeException

maxItemsInObjectGraph 値が 0 未満です。

例

次の例では、NetDataContractSerializer を使用して、StreamingContext のインスタンスを作成しています。このコードはまた、ignoreExtensionDataObject を設定し、従来の種類を逆シリアル化するためのサロゲートの選択時にシリアライザーの支援処理を行う ISurrogateSelector インターフェイスの実装を指定します。

public static void Constructor5()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);

    // Create an instance of a class that implements the
    // ISurrogateSelector interface. The implementation code
    // is not shown here.
    MySelector mySurrogateSelector = new MySelector();

    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        sc,
        int.MaxValue,
        true,
        FormatterAssemblyStyle.Simple,
        mySurrogateSelector);

    // Other code not shown.
}

Public Shared Sub Constructor5() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    
    ' Create an instance of a class that implements the 
    ' ISurrogateSelector interface. The implementation code
    ' is not shown here.
    Dim mySurrogateSelector As New MySelector()
    
    Dim ser As New System.Runtime.Serialization. _
    NetDataContractSerializer _
    (sc, _
     65536, _
     True, _
     FormatterAssemblyStyle.Simple, _
     mySurrogateSelector)

    ' Other code not shown.
End Sub

注釈

シリアル化または逆シリアル化されるクラス内で ignoreExtensionDataObject インターフェイスが実装される場合、IExtensibleDataObject パラメーターが使用されます。

適用対象

NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

コンテキストデータ、ルート名、シリアル化されるオブジェクト内の項目の最大数、追加データを無視するかどうかを指定するパラメーター、アセンブリを読み込むメソッドを指定するパラメーター、およびサロゲートセレクターを指定するパラメーターを使用して、NetDataContractSerializer クラスの新しいインスタンスを初期化します。

public:
 NetDataContractSerializer(System::String ^ rootName, System::String ^ rootNamespace, System::Runtime::Serialization::StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System::Runtime::Serialization::Formatters::FormatterAssemblyStyle assemblyFormat, System::Runtime::Serialization::ISurrogateSelector ^ surrogateSelector);

public NetDataContractSerializer (string rootName, string rootNamespace, System.Runtime.Serialization.StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System.Runtime.Serialization.Formatters.FormatterAssemblyStyle assemblyFormat, System.Runtime.Serialization.ISurrogateSelector surrogateSelector);

new System.Runtime.Serialization.NetDataContractSerializer : string * string * System.Runtime.Serialization.StreamingContext * int * bool * System.Runtime.Serialization.Formatters.FormatterAssemblyStyle * System.Runtime.Serialization.ISurrogateSelector -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (rootName As String, rootNamespace As String, context As StreamingContext, maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, assemblyFormat As FormatterAssemblyStyle, surrogateSelector As ISurrogateSelector)

パラメーター

rootName: String

シリアル化または逆シリアル化するコンテンツを囲む XML 要素の名前。

rootNamespace: String

シリアル化または逆シリアル化するコンテンツを囲む XML 要素の名前空間。

context: StreamingContext

コンテキストデータを含む StreamingContext。

maxItemsInObjectGraph: Int32

シリアル化または逆シリアル化するグラフ内の項目の最大数。

ignoreExtensionDataObject: Boolean

種類の拡張機能により提供されるデータを無視する場合は true。それ以外の場合は false。

assemblyFormat: FormatterAssemblyStyle

アセンブリの検索および読み込みをするメソッドを指定する FormatterAssemblyStyle 値。

surrogateSelector: ISurrogateSelector

従来の型を処理するための IDataContractSurrogate の実装。

例外

ArgumentOutOfRangeException

maxItemsInObjectGraph 値が 0 未満です。

例

逆シリアル化するときに予想する XML 要素名と名前空間を指定して、NetDataContractSerializer のインスタンスを作成する例を次に示します。このコードはまた、ignoreExtensionDataObject を設定し、従来の種類を逆シリアル化するためのサロゲートの選択時にシリアライザーの支援処理を行う ISurrogateSelector インターフェイスの実装を指定します。

public static void Constructor6()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);

    // Create an instance of a class that implements the
    // ISurrogateSelector interface. The implementation code
    // is not shown here.
    MySelector mySurrogateSelector = new MySelector();

    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        "Customer",
        "http://www.contoso.com",
        sc,
        int.MaxValue,
        true,
        FormatterAssemblyStyle.Simple,
        mySurrogateSelector);
    // Other code not shown.
}

Public Shared Sub Constructor6() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    
    ' Create an instance of a class that implements the 
    ' ISurrogateSelector interface. The implementation code
    ' is not shown here.
    Dim mySurrogateSelector As New MySelector()
    
    Dim ser As New System.Runtime.Serialization. _
      NetDataContractSerializer( _
      "Customer", _
      "http://www.contoso.com", _
      sc, _
      65536, _
      True, _
      FormatterAssemblyStyle.Simple, _
      mySurrogateSelector)

    ' Other code not shown.            

End Sub

注釈

適用対象

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

コンテキストデータ、ルート名、名前空間 (XmlDictionaryString パラメーターとして指定)、シリアル化されるオブジェクト内の項目の最大数、追加データを無視するかどうかを指定するパラメーター、アセンブリを読み込むメソッドを指定するパラメーター、サロゲートセレクターを指定するパラメーターを使用して、NetDataContractSerializer クラスの新しいインスタンスを初期化します。

public:
 NetDataContractSerializer(System::Xml::XmlDictionaryString ^ rootName, System::Xml::XmlDictionaryString ^ rootNamespace, System::Runtime::Serialization::StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System::Runtime::Serialization::Formatters::FormatterAssemblyStyle assemblyFormat, System::Runtime::Serialization::ISurrogateSelector ^ surrogateSelector);

public NetDataContractSerializer (System.Xml.XmlDictionaryString rootName, System.Xml.XmlDictionaryString rootNamespace, System.Runtime.Serialization.StreamingContext context, int maxItemsInObjectGraph, bool ignoreExtensionDataObject, System.Runtime.Serialization.Formatters.FormatterAssemblyStyle assemblyFormat, System.Runtime.Serialization.ISurrogateSelector surrogateSelector);

new System.Runtime.Serialization.NetDataContractSerializer : System.Xml.XmlDictionaryString * System.Xml.XmlDictionaryString * System.Runtime.Serialization.StreamingContext * int * bool * System.Runtime.Serialization.Formatters.FormatterAssemblyStyle * System.Runtime.Serialization.ISurrogateSelector -> System.Runtime.Serialization.NetDataContractSerializer

Public Sub New (rootName As XmlDictionaryString, rootNamespace As XmlDictionaryString, context As StreamingContext, maxItemsInObjectGraph As Integer, ignoreExtensionDataObject As Boolean, assemblyFormat As FormatterAssemblyStyle, surrogateSelector As ISurrogateSelector)

パラメーター

rootName: XmlDictionaryString

コンテンツのルート要素を含む XmlDictionaryString。

rootNamespace: XmlDictionaryString

ルート要素の名前空間を含む XmlDictionaryString。

context: StreamingContext

コンテキストデータを含む StreamingContext。

maxItemsInObjectGraph: Int32

シリアル化または逆シリアル化するグラフ内の項目の最大数。

ignoreExtensionDataObject: Boolean

種類の拡張機能により提供されるデータを無視する場合は true。それ以外の場合は false。

assemblyFormat: FormatterAssemblyStyle

アセンブリの検索および読み込みをするメソッドを指定する FormatterAssemblyStyle 値。

surrogateSelector: ISurrogateSelector

従来の型を処理するための IDataContractSurrogate の実装。

例外

ArgumentOutOfRangeException

maxItemsInObjectGraph 値が 0 未満です。

例

逆シリアル化するときに予想する XML 要素名と名前空間 (XmlDictionaryString 引数として指定) を指定して、NetDataContractSerializer のインスタンスを作成する例を次に示します。このコードはまた、ignoreExtensionDataObject を設定し、従来の種類を逆シリアル化するためのサロゲートの選択時にシリアライザーの支援処理を行う ISurrogateSelector インターフェイスの実装を指定します。

public static void Constructor7()
{
    // Create an instance of the StreamingContext to hold
    // context data.
    StreamingContext sc = new StreamingContext
        (StreamingContextStates.CrossAppDomain);

    // Create an XmlDictionary and add values to it.
    XmlDictionary d = new XmlDictionary();
    XmlDictionaryString name_value = d.Add("Customer");
    XmlDictionaryString ns_value = d.Add("http://www.contoso.com");

    // Create an instance of a class that implements the
    // ISurrogateSelector interface. The implementation code
    // is not shown here.
    MySelector mySurrogateSelector = new MySelector();

    NetDataContractSerializer ser =
        new NetDataContractSerializer(
        name_value,
        ns_value,
        sc,
        int.MaxValue,
        true,
        FormatterAssemblyStyle.Simple,
        mySurrogateSelector);

    // Other code not shown.
}

Public Shared Sub Constructor7() 
    ' Create an instance of the StreamingContext to hold
    ' context data.
    Dim sc As New StreamingContext()
    
    ' Create an XmlDictionary and add values to it.
    Dim d As New XmlDictionary()
    Dim name_value As XmlDictionaryString =d.Add("Customer")
    Dim ns_value As XmlDictionaryString = d.Add("http://www.contoso.com")
    
    ' Create an instance of a class that implements the 
    ' ISurrogateSelector interface. The implementation code
    ' is not shown here.
    Dim mySurrogateSelector As New MySelector()
    
    Dim ser As New System.Runtime.Serialization. _
      NetDataContractSerializer( _
      name_value, _
      ns_value, _
      sc, _
      65536, _
      True, _
      FormatterAssemblyStyle.Simple, _
      mySurrogateSelector)

    ' Other code not shown.    

End Sub

注釈

オブジェクトインスタンス間で同じ文字列のセットが使用される場合は、XmlDictionaryString を使用してパフォーマンスを最適化できます。

適用対象

NetDataContractSerializer コンストラクター

定義

オーバーロード

NetDataContractSerializer()

例

適用対象

NetDataContractSerializer(StreamingContext)

パラメーター

例

注釈

適用対象

NetDataContractSerializer(String, String)

パラメーター

例

適用対象

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

パラメーター

例

注釈

適用対象

NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

パラメーター

例外

例

注釈

適用対象

NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

パラメーター

例外

例

注釈

適用対象

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)

パラメーター

例外

例

注釈

適用対象

その他のリソース