NetDataContractSerializer Constructeurs

Définition

Initialise une nouvelle instance de la classe NetDataContractSerializer.

Surcharges

NetDataContractSerializer()

Initialise une nouvelle instance de la classe NetDataContractSerializer.

NetDataContractSerializer(StreamingContext)

Initialise une nouvelle instance de la classe NetDataContractSerializer avec les données de contexte de diffusion en continu fournies.

NetDataContractSerializer(String, String)

Initialise une nouvelle instance de la classe NetDataContractSerializer avec l'élément racine XML et l'espace de noms fourni.

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Initialise une nouvelle instance de la classe NetDataContractSerializer avec les deux paramètres de type XmlDictionaryString qui contiennent l'élément racine et l'espace de noms utilisé pour spécifier le contenu.

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

Initialise une nouvelle instance de la classe NetDataContractSerializer avec les données de contexte fournies ; de plus, spécifie le nombre maximal d'éléments dans l'objet à sérialiser et les paramètres à spécifier, si les données supplémentaires sont ignorées, la méthode de chargement d'assembly et un sélecteur de substitut.

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

Initialise une nouvelle instance de la classe NetDataContractSerializer avec les données de contexte, nom racine et espace de noms fournis ; de plus, spécifie le nombre maximal d'éléments dans l'objet à sérialiser et les paramètres à spécifier, si les données supplémentaires sont ignorées, la méthode de chargement d'assembly et un sélecteur de substitut.

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

Initialise une nouvelle instance de la classe NetDataContractSerializer avec les données de contexte, nom racine et espace de noms fournis (sous forme de paramètres XmlDictionaryString) ; de plus, spécifie le nombre maximal d'éléments dans l'objet à sérialiser et les paramètres à spécifier, si les données supplémentaires trouvées sont ignorées, la méthode de chargement d'assembly et un sélecteur de substitut.

NetDataContractSerializer()

Initialise une nouvelle instance de la classe NetDataContractSerializer.

public:
 NetDataContractSerializer();
public NetDataContractSerializer ();
Public Sub New ()

Exemples

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.

S’applique à

NetDataContractSerializer(StreamingContext)

Initialise une nouvelle instance de la classe NetDataContractSerializer avec les données de contexte de diffusion en continu fournies.

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)

Paramètres

context
StreamingContext

StreamingContext qui contient les données de contexte.

Exemples

L'exemple suivant crée une instance de NetDataContractSerializer à l'aide d 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

Remarques

La classe StreamingContext vous permet de passer des données de contexte spécifiques aux utilisateurs à utiliser pendant la lecture et l'écriture des objets.

S’applique à

NetDataContractSerializer(String, String)

Initialise une nouvelle instance de la classe NetDataContractSerializer avec l'élément racine XML et l'espace de noms fourni.

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)

Paramètres

rootName
String

Nom de l'élément XML renfermant le contenu à sérialiser ou désérialiser.

rootNamespace
String

Espace de noms de l'élément XML renfermant le contenu à sérialiser ou désérialiser.

Exemples

L'exemple suivant crée une instance du DataContractSerializer qui spécifie l'élément racine XML et l'espace de noms qu'il attendra lors de la désérialisation d'un objet.

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

S’applique à

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Initialise une nouvelle instance de la classe NetDataContractSerializer avec les deux paramètres de type XmlDictionaryString qui contiennent l'élément racine et l'espace de noms utilisé pour spécifier le contenu.

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)

Paramètres

rootName
XmlDictionaryString

XmlDictionaryString qui contient le nom de l'élément XML qui contient le contenu à sérialiser ou désérialiser.

rootNamespace
XmlDictionaryString

XmlDictionaryString qui contient l'espace de noms de l'élément XML qui contient le contenu à sérialiser ou désérialiser.

Exemples

L’exemple suivant crée une instance de la classe DataContractSerializer qui spécifie l’élément racine XML et l’espace de noms (sous forme d’arguments XmlDictionaryString) qu’il attendra lors de la désérialisation d’un objet.

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

Remarques

La classe XmlDictionaryString peut être utilisée pour optimiser les performances lorsque le même ensemble de chaînes est utilisé sur plusieurs instances d'objet.

S’applique à

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

Initialise une nouvelle instance de la classe NetDataContractSerializer avec les données de contexte fournies ; de plus, spécifie le nombre maximal d'éléments dans l'objet à sérialiser et les paramètres à spécifier, si les données supplémentaires sont ignorées, la méthode de chargement d'assembly et un sélecteur de substitut.

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)

Paramètres

context
StreamingContext

StreamingContext qui contient les données de contexte.

maxItemsInObjectGraph
Int32

Nombre maximal d'éléments à sérialiser ou désérialiser dans le graphique.

ignoreExtensionDataObject
Boolean

true pour ignorer les données fournies par une extension du type ; sinon, false.

assemblyFormat
FormatterAssemblyStyle

Valeur d'énumération FormatterAssemblyStyle qui spécifie une méthode de localisation et de chargement des assemblys.

surrogateSelector
ISurrogateSelector

Implémentation de ISurrogateSelector.

Exceptions

maxItemsInObjectGraph est inférieur à 0.

Exemples

L'exemple suivant crée une instance de NetDataContractSerializer à l'aide d StreamingContext. Le code définit également ignoreExtensionDataObject, et spécifie une implémentation de l'interface ISurrogateSelector à gérer pour aider le sérialiseur lors de la sélection d'un substitut (pour désérialiser des types hérités).

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

Remarques

Le paramètre ignoreExtensionDataObject est utilisé lorsque l'interface IExtensibleDataObject est implémentée dans la classe qui est sérialisée ou désérialisée.

S’applique à

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

Initialise une nouvelle instance de la classe NetDataContractSerializer avec les données de contexte, nom racine et espace de noms fournis ; de plus, spécifie le nombre maximal d'éléments dans l'objet à sérialiser et les paramètres à spécifier, si les données supplémentaires sont ignorées, la méthode de chargement d'assembly et un sélecteur de substitut.

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)

Paramètres

rootName
String

Nom de l'élément XML renfermant le contenu à sérialiser ou désérialiser.

rootNamespace
String

Espace de noms de l'élément XML renfermant le contenu à sérialiser ou désérialiser.

context
StreamingContext

StreamingContext qui contient les données de contexte.

maxItemsInObjectGraph
Int32

Nombre maximal d'éléments à sérialiser ou désérialiser dans le graphique.

ignoreExtensionDataObject
Boolean

true pour ignorer les données fournies par une extension du type ; sinon, false.

assemblyFormat
FormatterAssemblyStyle

Valeur d'énumération FormatterAssemblyStyle qui spécifie une méthode de localisation et de chargement des assemblys.

surrogateSelector
ISurrogateSelector

Implémentation de l'interface IDataContractSurrogate pour gérer le type hérité.

Exceptions

maxItemsInObjectGraph est inférieur à 0.

Exemples

L'exemple suivant crée une instance de la classe NetDataContractSerializer qui spécifie le nom d'élément XML et l'espace de noms attendus lors de la désérialisation. Le code définit également ignoreExtensionDataObject, et spécifie une implémentation de l'interface ISurrogateSelector à gérer pour aider le sérialiseur lors de la sélection d'un substitut (pour désérialiser des types hérités).

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

Remarques

Le paramètre ignoreExtensionDataObject est utilisé lorsque l'interface IExtensibleDataObject est implémentée dans la classe qui est sérialisée ou désérialisée.

S’applique à

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

Initialise une nouvelle instance de la classe NetDataContractSerializer avec les données de contexte, nom racine et espace de noms fournis (sous forme de paramètres XmlDictionaryString) ; de plus, spécifie le nombre maximal d'éléments dans l'objet à sérialiser et les paramètres à spécifier, si les données supplémentaires trouvées sont ignorées, la méthode de chargement d'assembly et un sélecteur de substitut.

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)

Paramètres

rootName
XmlDictionaryString

Classe XmlDictionaryString qui contient l'élément racine du contenu.

rootNamespace
XmlDictionaryString

Classe XmlDictionaryString qui contient l'espace de nom de l'élément racine.

context
StreamingContext

StreamingContext qui contient les données de contexte.

maxItemsInObjectGraph
Int32

Nombre maximal d'éléments à sérialiser ou désérialiser dans le graphique.

ignoreExtensionDataObject
Boolean

true pour ignorer les données fournies par une extension du type ; sinon, false.

assemblyFormat
FormatterAssemblyStyle

Valeur d'énumération FormatterAssemblyStyle qui spécifie une méthode de localisation et de chargement des assemblys.

surrogateSelector
ISurrogateSelector

Implémentation de l'interface IDataContractSurrogate pour gérer le type hérité.

Exceptions

maxItemsInObjectGraph est inférieur à 0.

Exemples

L’exemple suivant crée une instance de la classe NetDataContractSerializer qui spécifie (sous forme d’arguments XmlDictionaryString) le nom d’élément XML et l’espace de noms attendus lors de la désérialisation. Le code définit également ignoreExtensionDataObject, et spécifie une implémentation de l'interface ISurrogateSelector à gérer pour aider le sérialiseur lors de la sélection d'un substitut (pour désérialiser des types hérités).

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

Remarques

La classe XmlDictionaryString peut être utilisée pour optimiser les performances lorsque le même ensemble de chaînes est utilisé sur plusieurs instances d'objet.

Le paramètre ignoreExtensionDataObject est utilisé lorsque l'interface IExtensibleDataObject est implémentée dans la classe qui est sérialisée ou désérialisée.

S’applique à