NetDataContractSerializer Konstruktory

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.Serialization

Zestaw:: System.Runtime.Serialization.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Inicjuje nowe wystąpienie klasy NetDataContractSerializer.

Przeciążenia

NetDataContractSerializer()	Inicjuje nowe wystąpienie klasy NetDataContractSerializer.
NetDataContractSerializer(StreamingContext)	Inicjuje NetDataContractSerializer nowe wystąpienie klasy z dostarczonymi danymi kontekstu przesyłania strumieniowego.
NetDataContractSerializer(String, String)	Inicjuje NetDataContractSerializer nowe wystąpienie klasy z podanym elementem głównym XML i przestrzenią nazw.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)	Inicjuje NetDataContractSerializer nowe wystąpienie klasy z dwoma parametrami typu XmlDictionaryString zawierającymi element główny i przestrzeń nazw używaną do określania zawartości.
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicjuje nowe wystąpienie NetDataContractSerializer klasy z podanymi danymi kontekstu. Ponadto określa maksymalną liczbę elementów w obiekcie do serializacji, a parametry określające, czy dodatkowe dane są ignorowane, metoda ładowania zestawu i selektor zastępczy.
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicjuje nowe wystąpienie NetDataContractSerializer klasy z podanymi danymi kontekstu oraz główną nazwą i przestrzenią nazw. Ponadto określa maksymalną liczbę elementów w obiekcie, które mają być serializowane, oraz parametry, aby określić, czy dodatkowe dane są ignorowane, metoda ładowania zestawu i selektor zastępczy.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Inicjuje nowe wystąpienie NetDataContractSerializer klasy z podanymi danymi kontekstu oraz nazwę katalogu głównego i przestrzeń nazw (jako XmlDictionaryString parametry); ponadto określa maksymalną liczbę elementów w obiekcie, które mają być serializowane, oraz parametry, aby określić, czy znalezione dodatkowe dane są ignorowane, metoda ładowania zestawu i selektor zastępczy.

NetDataContractSerializer()

Inicjuje nowe wystąpienie klasy NetDataContractSerializer.

public:
 NetDataContractSerializer();

public NetDataContractSerializer ();

Public Sub New ()

Przykłady

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.

Dotyczy

NetDataContractSerializer(StreamingContext)

Inicjuje NetDataContractSerializer nowe wystąpienie klasy z dostarczonymi danymi kontekstu przesyłania strumieniowego.

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)

Parametry

context: StreamingContext

Obiekt StreamingContext zawierający dane kontekstowe.

Przykłady

Poniższy przykład tworzy wystąpienie NetDataContractSerializer obiektu przy użyciu klasy 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

Uwagi

Klasa StreamingContext umożliwia przekazywanie danych kontekstowych specyficznych dla użytkownika do użycia podczas odczytywania i zapisywania obiektów.

Dotyczy

NetDataContractSerializer(String, String)

Inicjuje NetDataContractSerializer nowe wystąpienie klasy z podanym elementem głównym XML i przestrzenią nazw.

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)

Parametry

rootName: String

Nazwa elementu XML otaczającego zawartość w celu serializacji lub deserializacji.

rootNamespace: String

Przestrzeń nazw elementu XML, który otacza zawartość serializacji lub deserializacji.

Przykłady

Poniższy przykład tworzy wystąpienie DataContractSerializer elementu głównego XML i przestrzeń nazw, której będzie oczekiwać podczas deserializacji obiektu.

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

Dotyczy

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Inicjuje NetDataContractSerializer nowe wystąpienie klasy z dwoma parametrami typu XmlDictionaryString zawierającymi element główny i przestrzeń nazw używaną do określania zawartości.

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)

Parametry

rootName: XmlDictionaryString

Element XmlDictionaryString , który zawiera nazwę elementu XML, który otacza zawartość serializacji lub deserializacji.

rootNamespace: XmlDictionaryString

Element XmlDictionaryString , który zawiera przestrzeń nazw elementu XML, który otacza zawartość serializacji lub deserializacji.

Przykłady

Poniższy przykład tworzy wystąpienie DataContractSerializer elementu głównego XML i przestrzeni nazw (jako XmlDictionaryString argumenty) będzie oczekiwać podczas deserializacji obiektu.

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

Uwagi

Można XmlDictionaryString go użyć do optymalizacji wydajności, gdy ten sam zestaw ciągów jest używany w wystąpieniach obiektów.

Dotyczy

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

Inicjuje nowe wystąpienie NetDataContractSerializer klasy z podanymi danymi kontekstu. Ponadto określa maksymalną liczbę elementów w obiekcie do serializacji, a parametry określające, czy dodatkowe dane są ignorowane, metoda ładowania zestawu i selektor zastępczy.

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)

Parametry

context: StreamingContext

Obiekt StreamingContext zawierający dane kontekstowe.

maxItemsInObjectGraph: Int32

Maksymalna liczba elementów na grafie do serializacji lub deserializacji.

ignoreExtensionDataObject: Boolean

true ignorowanie danych dostarczonych przez rozszerzenie typu; w przeciwnym razie , false.

assemblyFormat: FormatterAssemblyStyle

FormatterAssemblyStyle Wartość wyliczenia określająca metodę lokalizowania i ładowania zestawów.

surrogateSelector: ISurrogateSelector

Implementacja elementu ISurrogateSelector.

Wyjątki

ArgumentOutOfRangeException

maxItemsInObjectGraph wartość jest mniejsza niż 0.

Przykłady

Poniższy przykład tworzy wystąpienie NetDataContractSerializer obiektu przy użyciu klasy StreamingContext. Kod ustawia ignoreExtensionDataObjectrównież element i określa implementację interfejsu ISurrogateSelector do obsługi w celu ułatwienia serializatora podczas wybierania zastępczego (w celu deserializacji starszych typów).

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

Uwagi

Parametr ignoreExtensionDataObject jest używany, gdy IExtensibleDataObject interfejs jest implementowany w klasie, która jest serializowana lub deserializowany.

Dotyczy

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

Inicjuje nowe wystąpienie NetDataContractSerializer klasy z podanymi danymi kontekstu oraz główną nazwą i przestrzenią nazw. Ponadto określa maksymalną liczbę elementów w obiekcie, które mają być serializowane, oraz parametry, aby określić, czy dodatkowe dane są ignorowane, metoda ładowania zestawu i selektor zastępczy.

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)

Parametry

rootName: String

Nazwa elementu XML otaczającego zawartość w celu serializacji lub deserializacji.

rootNamespace: String

Przestrzeń nazw elementu XML, który otacza zawartość serializacji lub deserializacji.

context: StreamingContext

Obiekt StreamingContext zawierający dane kontekstowe.

maxItemsInObjectGraph: Int32

Maksymalna liczba elementów na grafie do serializacji lub deserializacji.

ignoreExtensionDataObject: Boolean

true ignorowanie danych dostarczonych przez rozszerzenie typu; w przeciwnym razie , false.

assemblyFormat: FormatterAssemblyStyle

FormatterAssemblyStyle Wartość wyliczenia określająca metodę lokalizowania i ładowania zestawów.

surrogateSelector: ISurrogateSelector

Implementacja elementu IDataContractSurrogate do obsługi starszego typu.

Wyjątki

ArgumentOutOfRangeException

maxItemsInObjectGraph wartość jest mniejsza niż 0.

Przykłady

Poniższy przykład tworzy wystąpienie NetDataContractSerializer określającą nazwę elementu XML i przestrzeń nazw oczekiwaną podczas deserializacji. Kod ustawia ignoreExtensionDataObjectrównież element i określa implementację interfejsu ISurrogateSelector do obsługi w celu ułatwienia serializatora podczas wybierania zastępczego (w celu deserializacji starszych typów).

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

Uwagi

Parametr ignoreExtensionDataObject jest używany, gdy IExtensibleDataObject interfejs jest implementowany w klasie, która jest serializowana lub deserializowany.

Dotyczy

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

Inicjuje nowe wystąpienie NetDataContractSerializer klasy z podanymi danymi kontekstu oraz nazwę katalogu głównego i przestrzeń nazw (jako XmlDictionaryString parametry); ponadto określa maksymalną liczbę elementów w obiekcie, które mają być serializowane, oraz parametry, aby określić, czy znalezione dodatkowe dane są ignorowane, metoda ładowania zestawu i selektor zastępczy.

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)

Parametry

rootName: XmlDictionaryString

Element XmlDictionaryString zawierający element główny zawartości.

rootNamespace: XmlDictionaryString

Element XmlDictionaryString zawierający przestrzeń nazw elementu głównego.

context: StreamingContext

Obiekt StreamingContext zawierający dane kontekstowe.

maxItemsInObjectGraph: Int32

Maksymalna liczba elementów na grafie do serializacji lub deserializacji.

ignoreExtensionDataObject: Boolean

true ignorowanie danych dostarczonych przez rozszerzenie typu; w przeciwnym razie , false.

assemblyFormat: FormatterAssemblyStyle

FormatterAssemblyStyle Wartość wyliczenia określająca metodę lokalizowania i ładowania zestawów.

surrogateSelector: ISurrogateSelector

Implementacja elementu IDataContractSurrogate do obsługi starszego typu.

Wyjątki

ArgumentOutOfRangeException

maxItemsInObjectGraph wartość jest mniejsza niż 0.

Przykłady

Poniższy przykład tworzy wystąpienie NetDataContractSerializer określającą nazwę elementu XML i przestrzeń nazw (jako XmlDictionaryString argumenty) oczekiwaną podczas deserializacji. Kod ustawia ignoreExtensionDataObjectrównież element i określa implementację interfejsu ISurrogateSelector do obsługi w celu ułatwienia serializatora podczas wybierania zastępczego (w celu deserializacji starszych typów).

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

Uwagi

Można XmlDictionaryString go użyć do optymalizacji wydajności, gdy ten sam zestaw ciągów jest używany w wystąpieniach obiektów.

Parametr ignoreExtensionDataObject jest używany, gdy IExtensibleDataObject interfejs jest implementowany w klasie, która jest serializowana lub deserializowany.

Dotyczy

Udostępnij za pośrednictwem

NetDataContractSerializer Konstruktory

Definicja

Przeciążenia

NetDataContractSerializer()

Przykłady

Dotyczy

NetDataContractSerializer(StreamingContext)

Parametry

Przykłady

Uwagi

Dotyczy

NetDataContractSerializer(String, String)

Parametry

Przykłady

Dotyczy

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

Parametry

Przykłady

Uwagi

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

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

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Opinia

Dodatkowe zasoby