次の方法で共有


NetDataContractSerializer コンストラクター

定義

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 の実装。

例外

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 の実装。

例外

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

注釈

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

適用対象

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 の実装。

例外

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 を使用してパフォーマンスを最適化できます。

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

適用対象