NetDataContractSerializer Constructeurs

Définition

Espace de noms:: System.Runtime.Serialization

Assembly:: System.Runtime.Serialization.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la classe NetDataContractSerializer.

Surcharges

Nom	Description
NetDataContractSerializer()	Initialise une nouvelle instance de la classe NetDataContractSerializer.
NetDataContractSerializer(StreamingContext)	Initialise une nouvelle instance de la NetDataContractSerializer classe avec les données de contexte de streaming fournies.
NetDataContractSerializer(String, String)	Initialise une nouvelle instance de la NetDataContractSerializer classe avec l’élément racine XML et l’espace de noms fournis.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)	Initialise une nouvelle instance de la NetDataContractSerializer classe avec deux paramètres de type XmlDictionaryString qui contiennent l’élément racine et l’espace de noms utilisés pour spécifier le contenu.
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Initialise une nouvelle instance de la NetDataContractSerializer classe avec les données de contexte fournies ; en outre, spécifie le nombre maximal d’éléments dans l’objet à sérialiser et les paramètres pour spécifier si des données supplémentaires sont ignorées, la méthode de chargement d’assembly et un sélecteur de substitution.
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Initialise une nouvelle instance de la NetDataContractSerializer classe avec les données de contexte et le nom racine et l’espace de noms fournis ; en outre, spécifie le nombre maximal d’éléments dans l’objet à sérialiser, et les paramètres pour spécifier si des données supplémentaires sont ignorées, la méthode de chargement d’assembly et un sélecteur de substitution.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Initialise une nouvelle instance de la NetDataContractSerializer classe avec les données de contexte fournies, et le nom racine et l’espace de noms (en tant que XmlDictionaryString paramètres) ; en outre, spécifie le nombre maximal d’éléments dans l’objet à sérialiser et les paramètres pour spécifier si des données supplémentaires trouvées sont ignorées, la méthode de chargement d’assembly et un sélecteur de substitution.

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 NetDataContractSerializer classe avec les données de contexte de streaming 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

Qui StreamingContext contient des données de contexte.

Exemples

L’exemple suivant crée une instance de l’utilisation d’un 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

Remarques

La StreamingContext classe vous permet de transmettre des données de contexte spécifiques à l’utilisateur à utiliser lors de la lecture et de l’écriture d’objets.

S’applique à

NetDataContractSerializer(String, String)

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

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 qui entoure le contenu à sérialiser ou désérialiser.

rootNamespace: String

Espace de noms de l’élément XML qui entoure le contenu à sérialiser ou désérialiser.

Exemples

L’exemple suivant crée une instance de l’élément racine XML et de l’espace DataContractSerializer de noms qu’il attend 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 NetDataContractSerializer classe avec deux paramètres de type XmlDictionaryString qui contiennent l’élément racine et l’espace de noms utilisés 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

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

rootNamespace: XmlDictionaryString

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

Exemples

L’exemple suivant crée une instance de l’élément racine XML et de l’espace DataContractSerializer de noms (en tant qu’arguments XmlDictionaryString ) qu’il attend 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

Vous XmlDictionaryString pouvez l’utiliser pour optimiser les performances lorsque le même ensemble de chaînes est utilisé entre les instances d’objet.

S’applique à

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

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

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

Qui StreamingContext contient des données de contexte.

maxItemsInObjectGraph: Int32

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

ignoreExtensionDataObject: Boolean

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

assemblyFormat: FormatterAssemblyStyle

Valeur FormatterAssemblyStyle d’énumération qui spécifie une méthode pour localiser et charger des assemblys.

surrogateSelector: ISurrogateSelector

Implémentation du ISurrogateSelector.

Exceptions

ArgumentOutOfRangeException

maxItemsInObjectGraph la valeur est inférieure à 0.

Exemples

L’exemple suivant crée une instance de l’utilisation d’un NetDataContractSerializer StreamingContext. Le code définit également le ignoreExtensionDataObjectcode et spécifie une implémentation de l’interface ISurrogateSelector à gérer pour aider le sérialiseur lors de la sélection d’une substitution (pour désérialiser les 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 ignoreExtensionDataObject paramètre est utilisé lorsque l’interface IExtensibleDataObject est implémentée dans la classe en cours de sérialisation ou de désérialisation.

S’applique à

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

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

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 qui entoure le contenu à sérialiser ou désérialiser.

rootNamespace: String

Espace de noms de l’élément XML qui entoure le contenu à sérialiser ou désérialiser.

context: StreamingContext

Qui StreamingContext contient des données de contexte.

maxItemsInObjectGraph: Int32

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

ignoreExtensionDataObject: Boolean

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

assemblyFormat: FormatterAssemblyStyle

Valeur FormatterAssemblyStyle d’énumération qui spécifie une méthode pour localiser et charger des assemblys.

surrogateSelector: ISurrogateSelector

Implémentation du IDataContractSurrogate type hérité pour gérer le type hérité.

Exceptions

ArgumentOutOfRangeException

maxItemsInObjectGraph la valeur est inférieure à 0.

Exemples

L’exemple suivant crée une instance du nom d’élément XML et de l’espace NetDataContractSerializer de noms à attendre lors de la désérialisation. Le code définit également le ignoreExtensionDataObjectcode et spécifie une implémentation de l’interface ISurrogateSelector à gérer pour aider le sérialiseur lors de la sélection d’une substitution (pour désérialiser les 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 ignoreExtensionDataObject paramètre est utilisé lorsque l’interface IExtensibleDataObject est implémentée dans la classe en cours de sérialisation ou de désérialisation.

S’applique à

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

Initialise une nouvelle instance de la NetDataContractSerializer classe avec les données de contexte fournies, et le nom racine et l’espace de noms (en tant que XmlDictionaryString paramètres) ; en outre, spécifie le nombre maximal d’éléments dans l’objet à sérialiser et les paramètres pour spécifier si des données supplémentaires trouvées sont ignorées, la méthode de chargement d’assembly et un sélecteur de substitution.

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

Qui XmlDictionaryString contient l’élément racine du contenu.

rootNamespace: XmlDictionaryString

Qui XmlDictionaryString contient l’espace de noms de l’élément racine.

context: StreamingContext

Qui StreamingContext contient des données de contexte.

maxItemsInObjectGraph: Int32

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

ignoreExtensionDataObject: Boolean

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

assemblyFormat: FormatterAssemblyStyle

Valeur FormatterAssemblyStyle d’énumération qui spécifie une méthode pour localiser et charger des assemblys.

surrogateSelector: ISurrogateSelector

Implémentation du IDataContractSurrogate type hérité pour gérer le type hérité.

Exceptions

ArgumentOutOfRangeException

maxItemsInObjectGraph la valeur est inférieure à 0.

Exemples

L’exemple suivant crée une instance de la spécification du nom d’élément XML et de l’espace NetDataContractSerializer de noms (en tant qu’arguments XmlDictionaryString ) à attendre lors de la désérialisation. Le code définit également le ignoreExtensionDataObjectcode et spécifie une implémentation de l’interface ISurrogateSelector à gérer pour aider le sérialiseur lors de la sélection d’une substitution (pour désérialiser les 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

Vous XmlDictionaryString pouvez l’utiliser pour optimiser les performances lorsque le même ensemble de chaînes est utilisé entre les instances d’objet.

Le ignoreExtensionDataObject paramètre est utilisé lorsque l’interface IExtensibleDataObject est implémentée dans la classe en cours de sérialisation ou de désérialisation.

S’applique à

Commentaires

Cette page a-t-elle été utile ?