NetDataContractSerializer Oluşturucular

Tanım

Ad Alanı:: System.Runtime.Serialization

Bütünleştirilmiş Kod:: System.Runtime.Serialization.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

NetDataContractSerializer sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

Name	Description
NetDataContractSerializer()	NetDataContractSerializer sınıfının yeni bir örneğini başlatır.
NetDataContractSerializer(StreamingContext)	Sağlanan akış bağlamı verileriyle sınıfının yeni bir örneğini NetDataContractSerializer başlatır.
NetDataContractSerializer(String, String)	Sağlanan XML kök öğesi ve ad alanı ile sınıfının yeni bir örneğini NetDataContractSerializer başlatır.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)	sınıfın NetDataContractSerializer yeni bir örneğini, içeriği belirtmek için kullanılan kök öğeyi ve ad alanını içeren iki XmlDictionaryString tür parametresiyle başlatır.
NetDataContractSerializer(StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Sınıfın NetDataContractSerializer yeni bir örneğini sağlanan bağlam verileriyle başlatır; buna ek olarak, serileştirilecek nesnedeki en fazla öğe sayısını ve ek verilerin yoksayılıp yoksayılmayacağını belirtmek için parametreleri, derleme yükleme yöntemini ve vekil seçiciyi belirtir.
NetDataContractSerializer(String, String, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Sağlanan bağlam verileri ve kök adı ve ad alanı ile sınıfının yeni bir örneğini NetDataContractSerializer başlatır; ayrıca, serileştirilecek nesnedeki en fazla öğe sayısını ve ek verilerin yoksayılıp yoksayılmayacağını belirtmek için parametreleri, derleme yükleme yöntemini ve vekil seçiciyi belirtir.
NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString, StreamingContext, Int32, Boolean, FormatterAssemblyStyle, ISurrogateSelector)	Sağlanan bağlam verileri ve kök adı ve ad alanı (parametre olarakNetDataContractSerializer) ile sınıfın XmlDictionaryString yeni bir örneğini başlatır; ayrıca, serileştirilecek nesnedeki en fazla öğe sayısını ve bulunan ek verilerin yoksayılıp yoksayılmayacağını belirtmek için parametreleri, derleme yükleme yöntemini ve vekil seçiciyi belirtir.

NetDataContractSerializer()

NetDataContractSerializer sınıfının yeni bir örneğini başlatır.

public:
 NetDataContractSerializer();

public NetDataContractSerializer();

Public Sub New ()

Örnekler

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.

Şunlara uygulanır

NetDataContractSerializer(StreamingContext)

Sağlanan akış bağlamı verileriyle sınıfının yeni bir örneğini NetDataContractSerializer başlatır.

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)

Parametreler

context: StreamingContext

StreamingContext Bağlam verilerini içeren bir.

Örnekler

Aşağıdaki örnek kullanarak öğesinin NetDataContractSerializer bir StreamingContextörneğini oluşturur.

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

Açıklamalar

sınıfı, StreamingContext nesneleri okurken ve yazarken kullanmak üzere kullanıcıya özgü bağlam verilerini geçirmenize olanak tanır.

Şunlara uygulanır

NetDataContractSerializer(String, String)

Sağlanan XML kök öğesi ve ad alanı ile sınıfının yeni bir örneğini NetDataContractSerializer başlatır.

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)

Parametreler

rootName: String

Seri hale getirmek veya seri durumdan çıkarmak için içeriği kapsayan XML öğesinin adı.

rootNamespace: String

serileştirmek veya seri durumdan çıkarmak için içeriği kapsayan XML öğesinin ad alanı.

Örnekler

Aşağıdaki örnek, bir nesneyi seri durumdan DataContractSerializer çıkarırken bekleyeceği XML kök öğesini ve ad alanını belirten bir örneği oluşturur.

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

Şunlara uygulanır

NetDataContractSerializer(XmlDictionaryString, XmlDictionaryString)

sınıfın NetDataContractSerializer yeni bir örneğini, içeriği belirtmek için kullanılan kök öğeyi ve ad alanını içeren iki XmlDictionaryString tür parametresiyle başlatır.

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)

Parametreler

rootName: XmlDictionaryString

XmlDictionaryString Seri hale getirmek veya seri durumdan çıkarmak için içeriği kapsayan XML öğesinin adını içeren.

rootNamespace: XmlDictionaryString

Seri XmlDictionaryString hale getirmek veya seri durumdan çıkarmak için içeriği kapsayan XML öğesinin ad alanını içeren.

Örnekler

Aşağıdaki örnek, bir nesneyi seri durumdan DataContractSerializer çıkarırken bekleyeceği XML kök öğesini ve ad alanını (bağımsız değişken olarak XmlDictionaryString ) belirten bir örneği oluşturur.

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

Açıklamalar

aynı XmlDictionaryString dize kümesi nesne örnekleri arasında kullanıldığında performansı iyileştirmek için kullanılabilir.

Şunlara uygulanır

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

Sınıfın NetDataContractSerializer yeni bir örneğini sağlanan bağlam verileriyle başlatır; buna ek olarak, serileştirilecek nesnedeki en fazla öğe sayısını ve ek verilerin yoksayılıp yoksayılmayacağını belirtmek için parametreleri, derleme yükleme yöntemini ve vekil seçiciyi belirtir.

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)

Parametreler

context: StreamingContext

StreamingContext Bağlam verilerini içeren bir.

maxItemsInObjectGraph: Int32

Grafikteki seri hale getirilmeye veya seri durumdan çıkarılırken en fazla öğe sayısı.

ignoreExtensionDataObject: Boolean

true türündeki bir uzantı tarafından sağlanan verileri yoksaymak; aksi takdirde , false.

assemblyFormat: FormatterAssemblyStyle

FormatterAssemblyStyle Derlemeleri bulmak ve yüklemek için bir yöntem belirten bir numaralandırma değeri.

surrogateSelector: ISurrogateSelector

uygulamasının ISurrogateSelectorbir uygulamasıdır.

Özel durumlar

ArgumentOutOfRangeException

maxItemsInObjectGraph değeri 0'dan küçüktür.

Örnekler

Aşağıdaki örnek kullanarak öğesinin NetDataContractSerializer bir StreamingContextörneğini oluşturur. Kod, bir vekil seçerken (eski türleri seri durumdan ignoreExtensionDataObject çıkarma için) seri hale getiriciye yardımcı olmak için arabiriminin uygulamasını da ayarlar ISurrogateSelectorve belirtir.

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

Açıklamalar

ignoreExtensionDataObject parametresi, arabirim seri hale getirilen veya seri durumdan çıkarılan sınıfta uygulandığında kullanılırIExtensibleDataObject.

Şunlara uygulanır

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

Sağlanan bağlam verileri ve kök adı ve ad alanı ile sınıfının yeni bir örneğini NetDataContractSerializer başlatır; ayrıca, serileştirilecek nesnedeki en fazla öğe sayısını ve ek verilerin yoksayılıp yoksayılmayacağını belirtmek için parametreleri, derleme yükleme yöntemini ve vekil seçiciyi belirtir.

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)

Parametreler

rootName: String

Seri hale getirmek veya seri durumdan çıkarmak için içeriği kapsayan XML öğesinin adı.

rootNamespace: String

serileştirmek veya seri durumdan çıkarmak için içeriği kapsayan XML öğesinin ad alanı.

context: StreamingContext

StreamingContext Bağlam verilerini içeren bir.

maxItemsInObjectGraph: Int32

Grafikteki seri hale getirilmeye veya seri durumdan çıkarılırken en fazla öğe sayısı.

ignoreExtensionDataObject: Boolean

true türündeki bir uzantı tarafından sağlanan verileri yoksaymak; aksi takdirde , false.

assemblyFormat: FormatterAssemblyStyle

FormatterAssemblyStyle Derlemeleri bulmak ve yüklemek için bir yöntem belirten bir numaralandırma değeri.

surrogateSelector: ISurrogateSelector

IDataContractSurrogate Eski türü işlemek için uygulaması.

Özel durumlar

ArgumentOutOfRangeException

maxItemsInObjectGraph değeri 0'dan küçüktür.

Örnekler

Aşağıdaki örnek, seri durumdan NetDataContractSerializer çıkarılırken beklenmesi gereken XML öğesi adını ve ad alanını belirten bir örneği oluşturur. Kod, bir vekil seçerken (eski türleri seri durumdan ignoreExtensionDataObject çıkarma için) seri hale getiriciye yardımcı olmak için arabiriminin uygulamasını da ayarlar ISurrogateSelectorve belirtir.

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

Açıklamalar

ignoreExtensionDataObject parametresi, arabirim seri hale getirilen veya seri durumdan çıkarılan sınıfta uygulandığında kullanılırIExtensibleDataObject.

Şunlara uygulanır

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

Sağlanan bağlam verileri ve kök adı ve ad alanı (parametre olarakNetDataContractSerializer) ile sınıfın XmlDictionaryString yeni bir örneğini başlatır; ayrıca, serileştirilecek nesnedeki en fazla öğe sayısını ve bulunan ek verilerin yoksayılıp yoksayılmayacağını belirtmek için parametreleri, derleme yükleme yöntemini ve vekil seçiciyi belirtir.

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)

Parametreler

rootName: XmlDictionaryString

XmlDictionaryString İçeriğin kök öğesini içeren.

rootNamespace: XmlDictionaryString

XmlDictionaryString Kök öğenin ad alanını içeren bir.

context: StreamingContext

StreamingContext Bağlam verilerini içeren bir.

maxItemsInObjectGraph: Int32

Grafikteki seri hale getirilmeye veya seri durumdan çıkarılırken en fazla öğe sayısı.

ignoreExtensionDataObject: Boolean

true türündeki bir uzantı tarafından sağlanan verileri yoksaymak; aksi takdirde , false.

assemblyFormat: FormatterAssemblyStyle

FormatterAssemblyStyle Derlemeleri bulmak ve yüklemek için bir yöntem belirten bir numaralandırma değeri.

surrogateSelector: ISurrogateSelector

IDataContractSurrogate Eski türü işlemek için uygulaması.

Özel durumlar

ArgumentOutOfRangeException

maxItemsInObjectGraph değeri 0'dan küçüktür.

Örnekler

Aşağıdaki örnek, seri durumdan NetDataContractSerializer çıkarılırken beklenmesi gereken XML öğesi adını ve ad alanını (bağımsız değişkenler olarak XmlDictionaryString ) belirten bir örneğini oluşturur. Kod, bir vekil seçerken (eski türleri seri durumdan ignoreExtensionDataObject çıkarma için) seri hale getiriciye yardımcı olmak için arabiriminin uygulamasını da ayarlar ISurrogateSelectorve belirtir.

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

Açıklamalar

aynı XmlDictionaryString dize kümesi nesne örnekleri arasında kullanıldığında performansı iyileştirmek için kullanılabilir.

ignoreExtensionDataObject parametresi, arabirim seri hale getirilen veya seri durumdan çıkarılan sınıfta uygulandığında kullanılırIExtensibleDataObject.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?