System.Xml.Serialization Przestrzeń nazw

System.Xml.Serialization Przestrzeń nazw zawiera klasy, które są używane do wykonywania serializacji obiektów w dokumentach formatu XML lub strumieni. The System.Xml.Serialization namespace contains classes that are used to serialize objects into XML format documents or streams.

Klasy

CodeExporter

Reprezentuje klasę, która może generować kod proxy na podstawie reprezentacji XML struktury danych.Represents a class that can generate proxy code from an XML representation of a data structure.

CodeIdentifier

Zapewnia statyczne metody konwersji tekstu wejściowego na nazwy dla jednostek kodu.Provides static methods to convert input text into names for code entities.

CodeIdentifiers

Utrzymuje grupę nazw powiązanych jednostek kodu lub mapowań typów, które są generowane przez infrastrukturę serializacji XML .NET Framework.Maintains a group of names for related code entities or type mappings that are generated by the .NET Framework's XML serialization infrastructure.

ImportContext

Opisuje kontekst, w którym zestaw schematów jest powiązany z .NET Framework jednostkami kodu.Describes the context in which a set of schema is bound to .NET Framework code entities.

SchemaImporter

Opisuje importera schematów.Describes a schema importer.

SoapAttributeAttribute

Określa, że XmlSerializer musi serializować element członkowski klasy jako zakodowany atrybut SOAP.Specifies that the XmlSerializer must serialize the class member as an encoded SOAP attribute.

SoapAttributeOverrides

Umożliwia przesłonięcie atrybutów zastosowanych do właściwości, pól i klas w przypadku użycia XmlSerializer do serializacji lub deserializacji obiektu jako zakodowanego protokołu SOAP.Allows you to override attributes applied to properties, fields, and classes when you use an XmlSerializer to serialize or deserialize an object as encoded SOAP.

SoapAttributes

Reprezentuje kolekcję obiektów atrybutów, które kontrolują sposób, w jaki XmlSerializer serializować i deserializacji metod protokołu SOAP.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes SOAP methods.

SoapCodeExporter

Generuje typy i deklaracje atrybutów z informacji o mapowaniu typów wewnętrznych dla części komunikatów zakodowanych przy użyciu protokołu SOAP zdefiniowanych w dokumencie WSDL.Generates types and attribute declarations from internal type mapping information for SOAP-encoded message parts defined in a WSDL document.

SoapElementAttribute

Określa, że publiczna wartość elementu członkowskiego jest serializowana przez XmlSerializer jako zakodowany element XML protokołu SOAP.Specifies that the public member value be serialized by the XmlSerializer as an encoded SOAP XML element.

SoapEnumAttribute

Kontroluje sposób serializacji przez XmlSerializer elementu członkowskiego wyliczenia.Controls how the XmlSerializer serializes an enumeration member.

SoapIgnoreAttribute

Instruuje XmlSerializer, aby nie serializować pola publicznego lub publicznej wartości właściwości odczytu/zapisu.Instructs the XmlSerializer not to serialize the public field or public read/write property value.

SoapIncludeAttribute

Zezwala XmlSerializer na rozpoznawanie typu podczas serializacji lub deserializacji obiektu jako zakodowanego XML protokołu SOAP.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object as encoded SOAP XML.

SoapReflectionImporter

Generuje mapowania do komunikatów zakodowanych przy użyciu protokołu SOAP z typów .NET Framework lub informacji o metodzie usługi sieci Web.Generates mappings to SOAP-encoded messages from .NET Framework types or Web service method information.

SoapSchemaExporter

Wypełnia XmlSchema obiektów przy użyciu definicji typu danych schematu XML dla typów .NET Framework, które są serializowane przy użyciu kodowania protokołu SOAP.Populates XmlSchema objects with XML Schema data type definitions for .NET Framework types that are serialized using SOAP encoding.

SoapSchemaImporter

Używane w .NET Framework do generowania mapowań wewnętrznych do typów .NET Framework dla elementów komunikatów kodowanych przy użyciu protokołu SOAP w dokumencie WSDL.Used within the .NET Framework to generate internal mappings to .NET Framework types for SOAP-encoded message parts in a WSDL document.

SoapSchemaMember

Reprezentuje pewne atrybuty <XSD part> elementu w dokumencie WSDL w celu wygenerowania klas z dokumentu.Represents certain attributes of a XSD <part> element in a WSDL document for generating classes from the document.

SoapTypeAttribute

Steruje schematem wygenerowanym przez XmlSerializer, gdy wystąpienie klasy jest serializowane jako zakodowany plik XML protokołu SOAP.Controls the schema generated by the XmlSerializer when a class instance is serialized as SOAP encoded XML.

UnreferencedObjectEventArgs

Dostarcza dane dla znanego, ale bez odwołania, obiektu znalezionego w zakodowanym strumieniu XML protokołu SOAP podczas deserializacji.Provides data for the known, but unreferenced, object found in an encoded SOAP XML stream during deserialization.

XmlAnyAttributeAttribute

Określa, że element członkowski (pole, które zwraca tablicę obiektów XmlAttribute) może zawierać wszelkie atrybuty XML.Specifies that the member (a field that returns an array of XmlAttribute objects) can contain any XML attributes.

XmlAnyElementAttribute

Określa, że element członkowski (pole, które zwraca tablicę obiektów XmlElement lub XmlNode) zawiera obiekty, które reprezentują dowolny element XML, który nie ma odpowiadającego mu elementu członkowskiego w serializowanym lub deserializowanym obiekcie.Specifies that the member (a field that returns an array of XmlElement or XmlNode objects) contains objects that represent any XML element that has no corresponding member in the object being serialized or deserialized.

XmlAnyElementAttributes

Reprezentuje kolekcję obiektów XmlAnyElementAttribute.Represents a collection of XmlAnyElementAttribute objects.

XmlArrayAttribute

Określa, że XmlSerializer musi serializować określony element członkowski klasy jako tablicę elementów XML.Specifies that the XmlSerializer must serialize a particular class member as an array of XML elements.

XmlArrayItemAttribute

Reprezentuje atrybut, który określa typy pochodne, które XmlSerializer mogą być umieszczone w serializowanej tablicy.Represents an attribute that specifies the derived types that the XmlSerializer can place in a serialized array.

XmlArrayItemAttributes

Reprezentuje kolekcję obiektów XmlArrayItemAttribute.Represents a collection of XmlArrayItemAttribute objects.

XmlAttributeAttribute

Określa, że XmlSerializer musi serializować element członkowski klasy jako atrybut XML.Specifies that the XmlSerializer must serialize the class member as an XML attribute.

XmlAttributeEventArgs

Udostępnia dane dla zdarzenia UnknownAttribute.Provides data for the UnknownAttribute event.

XmlAttributeOverrides

Umożliwia przesłonięcie atrybutów właściwości, pól i klas przy użyciu XmlSerializer do serializacji lub deserializacji obiektu.Allows you to override property, field, and class attributes when you use the XmlSerializer to serialize or deserialize an object.

XmlAttributes

Reprezentuje kolekcję obiektów atrybutów, które kontrolują sposób serializacji XmlSerializer i deserializacji obiektu.Represents a collection of attribute objects that control how the XmlSerializer serializes and deserializes an object.

XmlChoiceIdentifierAttribute

Określa, że element członkowski może być wykryty w sposób dodatkowy przy użyciu wyliczenia.Specifies that the member can be further detected by using an enumeration.

XmlCodeExporter

Generuje typy i deklaracje atrybutów z informacji o mapowaniu typu wewnętrznego dla deklaracji elementu schematu XML.Generates types and attribute declarations from internal type mapping information for XML schema element declarations.

XmlElementAttribute

Wskazuje, że pole lub właściwość publicznego reprezentuje element XML, gdy XmlSerializer deserializacji lub deserializacji obiektu, który go zawiera.Indicates that a public field or property represents an XML element when the XmlSerializer serializes or deserializes the object that contains it.

XmlElementAttributes

Reprezentuje kolekcję XmlElementAttribute obiektów używanych przez XmlSerializer do przesłania domyślnego sposobu serializacji klasy.Represents a collection of XmlElementAttribute objects used by the XmlSerializer to override the default way it serializes a class.

XmlElementEventArgs

Udostępnia dane dla zdarzenia UnknownElement.Provides data for the UnknownElement event.

XmlEnumAttribute

Kontroluje sposób serializacji przez XmlSerializer elementu członkowskiego wyliczenia.Controls how the XmlSerializer serializes an enumeration member.

XmlIgnoreAttribute

Instruuje Serialize(TextWriter, Object) metodę XmlSerializer, aby nie serializować pola publicznego lub publicznej wartości właściwości do odczytu/zapisu.Instructs the Serialize(TextWriter, Object) method of the XmlSerializer not to serialize the public field or public read/write property value.

XmlIncludeAttribute

Zezwala XmlSerializer na rozpoznawanie typu podczas serializacji lub deserializacji obiektu.Allows the XmlSerializer to recognize a type when it serializes or deserializes an object.

XmlMapping

Obsługuje mapowania między typami .NET Framework i typami danych schematu XML.Supports mappings between .NET Framework types and XML Schema data types.

XmlMemberMapping

Mapuje jednostkę kodu w metodzie usługi sieci Web .NET Framework na element w komunikacie Web Services Description Language (WSDL).Maps a code entity in a .NET Framework Web service method to an element in a Web Services Description Language (WSDL) message.

XmlMembersMapping

Zapewnia mapowania między metodami .NET Framework sieci Web i Web Services Description Language (WSDL) komunikatów, które są zdefiniowane dla usług sieci Web protokołu SOAP.Provides mappings between .NET Framework Web service methods and Web Services Description Language (WSDL) messages that are defined for SOAP Web services.

XmlNamespaceDeclarationsAttribute

Określa, że właściwość docelowa, parametr, wartość zwracana lub element członkowski klasy zawiera prefiksy skojarzone z przestrzeniami nazw, które są używane w dokumencie XML.Specifies that the target property, parameter, return value, or class member contains prefixes associated with namespaces that are used within an XML document.

XmlNodeEventArgs

Udostępnia dane dla zdarzenia UnknownNode.Provides data for the UnknownNode event.

XmlReflectionImporter

Generuje mapowania do deklaracji elementu schematu XML, w tym fragmenty komunikatów definicji schematu XML (XSD) w dokumencie Web Services Description Language (WSDL), dla typów .NET Framework lub informacji o metodzie usługi sieci Web.Generates mappings to XML schema element declarations, including literal XML Schema Definition (XSD) message parts in a Web Services Description Language (WSDL) document, for .NET Framework types or Web service method information.

XmlReflectionMember

Oferuje mapowania między jednostkami kodu w metodach usługi sieci Web .NET Framework i zawartości komunikatów Web Services Description Language (WSDL), które są zdefiniowane dla usług sieci Web protokołu SOAP.Provides mappings between code entities in .NET Framework Web service methods and the content of Web Services Description Language (WSDL) messages that are defined for SOAP Web services.

XmlRootAttribute

Formanty XML serializacji w celu atrybutu jako element główny XML.Controls XML serialization of the attribute target as an XML root element.

XmlSchemaEnumerator

Włącza iterację w kolekcji obiektów XmlSchema.Enables iteration over a collection of XmlSchema objects.

XmlSchemaExporter

Wypełnia obiekty XmlSchema za pomocą deklaracji elementów schematu XML, które znajdują się w obiektach mapowania typu.Populates XmlSchema objects with XML schema element declarations that are found in type mapping objects.

XmlSchemaImporter

Generuje wewnętrzne mapowania do typów .NET Framework dla deklaracji elementu schematu XML, w tym literałów części komunikatu XSD w dokumencie WSDL.Generates internal mappings to .NET Framework types for XML schema element declarations, including literal XSD message parts in a WSDL document.

XmlSchemaProviderAttribute

W przypadku zastosowania do typu przechowuje nazwę statycznej metody typu, która zwraca schemat XML i XmlQualifiedName (lub XmlSchemaType dla typów anonimowych), które sterują serializacji typu.When applied to a type, stores the name of a static method of the type that returns an XML schema and a XmlQualifiedName (or XmlSchemaType for anonymous types) that controls the serialization of the type.

XmlSchemas

Reprezentuje kolekcję schematów XML.Represents the collection of XML schemas.

XmlSerializationGeneratedCode

Klasa abstrakcyjna, która jest klasą bazową XmlSerializationWriter dla XmlSerializationReader i i która zawiera metody wspólne dla obu tych typów.An abstract class that is the base class for XmlSerializationReader and XmlSerializationWriter and that contains methods common to both of these types.

XmlSerializationReader

Kontroluje deserializacja przez klasę XmlSerializer.Controls deserialization by the XmlSerializer class.

XmlSerializationReader.CollectionFixup

Zawiera wystąpienie XmlSerializationCollectionFixupCallback delegata oraz dane wejściowe metody; dostarcza również parametry metody.Holds an XmlSerializationCollectionFixupCallback delegate instance, plus the method's inputs; also supplies the method's parameters.

XmlSerializationReader.Fixup

Zawiera wystąpienie XmlSerializationFixupCallback delegata oraz dane wejściowe metody; służy również jako parametr metody.Holds an XmlSerializationFixupCallback delegate instance, plus the method's inputs; also serves as the parameter for the method.

XmlSerializationWriter

Reprezentuje klasę abstrakcyjną służącą do kontrolowania serializacji za pomocą klasy XmlSerializer.Represents an abstract class used for controlling serialization by the XmlSerializer class.

XmlSerializer

Serializować i deserializacji obiektów do i z dokumentów XML.Serializes and deserializes objects into and from XML documents. XmlSerializer pozwala kontrolować sposób kodowania obiektów w formacie XML.The XmlSerializer enables you to control how objects are encoded into XML.

XmlSerializerAssemblyAttribute

Zastosowana do serwera proxy klienta usługi sieci Web umożliwia określenie zestawu, który zawiera serializatory utworzone przez użytkownika.Applied to a Web service client proxy, enables you to specify an assembly that contains custom-made serializers.

XmlSerializerFactory

Tworzy wpisane wersje XmlSerializer do wydajniejszej serializacji.Creates typed versions of the XmlSerializer for more efficient serialization.

XmlSerializerImplementation

Definiuje czytnik, składnik zapisywania i metody dla wstępnie generowanych i wpisanych serializatorów.Defines the reader, writer, and methods for pre-generated, typed serializers.

XmlSerializerNamespaces

Zawiera przestrzenie nazw XML i prefiksy, których XmlSerializer używa do generowania kwalifikowanych nazw w wystąpieniu dokumentu XML.Contains the XML namespaces and prefixes that the XmlSerializer uses to generate qualified names in an XML-document instance.

XmlSerializerVersionAttribute

Oznacza, że kod został wygenerowany przez infrastrukturę serializacji i może być ponownie używany w celu zwiększenia wydajności, gdy ten atrybut jest stosowany do zestawu.Signifies that the code was generated by the serialization infrastructure and can be reused for increased performance, when this attribute is applied to an assembly.

XmlTextAttribute

Wskazuje XmlSerializer, że element członkowski musi być traktowany jako tekst XML, gdy Klasa zawierająca ją jest serializowana lub deserializowana.Indicates to the XmlSerializer that the member must be treated as XML text when the class that contains it is serialized or deserialized.

XmlTypeAttribute

Steruje schematem XML, który jest generowany, gdy element docelowy atrybutu jest serializowany przez XmlSerializer.Controls the XML schema that is generated when the attribute target is serialized by the XmlSerializer.

XmlTypeMapping

Zawiera mapowanie jednego typu na drugi.Contains a mapping of one type to another.

Struktury

XmlDeserializationEvents

Zawiera pola, które mogą służyć do przekazywania delegatów zdarzeń do Deserialize bezpiecznej wątkowo metody XmlSerializer.Contains fields that can be used to pass event delegates to a thread-safe Deserialize method of the XmlSerializer.

Interfejsy

IXmlSerializable

Zapewnia niestandardowe formatowanie serializacji XML i deserializacji.Provides custom formatting for XML serialization and deserialization.

IXmlTextParser

Ustanawia Właściwość Normalized do użycia przez infrastrukturę .NET Framework.Establishes a Normalized property for use by the .NET Framework infrastructure.

Wyliczenia

CodeGenerationOptions

Określa różne opcje, które mają być używane podczas generowania typów .NET do użycia z usługą sieci Web XML.Specifies various options to use when generating .NET types for use with an XML Web Service.

XmlMappingAccess

Określa, czy mapowanie jest odczytane, zapisane czy oba.Specifies whether a mapping is read, write, or both.

Delegaci

UnreferencedObjectEventHandler

Reprezentuje metodę, która obsługuje zdarzenie UnreferencedObject XmlSerializer.Represents the method that handles the UnreferencedObject event of an XmlSerializer.

XmlAttributeEventHandler

Reprezentuje metodę, która obsługuje UnknownAttributeRepresents the method that handles the UnknownAttribute

XmlElementEventHandler

Reprezentuje metodę, która obsługuje zdarzenie UnknownElement XmlSerializer.Represents the method that handles the UnknownElement event of an XmlSerializer.

XmlNodeEventHandler

Reprezentuje metodę, która obsługuje zdarzenie UnknownNode XmlSerializer.Represents the method that handles the UnknownNode event of an XmlSerializer.

XmlSerializationCollectionFixupCallback

Delegat używany przez klasę XmlSerializer do deserializacji typów danych XML zakodowanych przy użyciu protokołu SOAP, które są mapowane na kolekcje lub wyliczenia.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data types that map to collections or enumerations.

XmlSerializationFixupCallback

Delegat używany przez klasę XmlSerializer do deserializacji danych XML zakodowanych przy użyciu protokołu SOAP.Delegate used by the XmlSerializer class for deserialization of SOAP-encoded XML data.

XmlSerializationReadCallback

Delegat używany przez klasę XmlSerializer do deserializacji typów z danych XML, które nie są oparte na protokole SOAP.Delegate used by the XmlSerializer class for deserialization of types from SOAP-encoded, non-root XML data.

XmlSerializationWriteCallback

Delegat, który jest używany przez klasę XmlSerializer do serializacji typów z danych XML, które nie są oparte na protokole SOAP.Delegate that is used by the XmlSerializer class for serialization of types from SOAP-encoded, non-root XML data.

Uwagi

Klasa centralnej w przestrzeni nazw jest XmlSerializer klasy.The central class in the namespace is the XmlSerializer class. Aby użyć tej klasy, należy użyć XmlSerializer konstruktora, aby utworzyć wystąpienie klasy za pomocą typ obiektu do zserializowania.To use this class, use the XmlSerializer constructor to create an instance of the class using the type of the object to serialize. Gdy XmlSerializer jest utworzone, Utwórz wystąpienie obiektu do zserializowania.Once an XmlSerializer is created, create an instance of the object to serialize. Należy także utworzyć obiekt do zapisania pliku do dokumentu lub strumienia, takich jak Stream, TextWriter, lub XmlWriter.You must also create an object to write the file to a document or stream, such as a Stream, TextWriter, or XmlWriter. Następnie możesz wywołać Serialize metodę, aby przekonwertować obiekt na dokumencie XML.You can then call the Serialize method to convert the object into an XML document.

Do deserializacji obiektu z dokumentu XML, należy utworzyć odpowiedni obiekt można odczytać dokumentu lub strumienia (ponownie Stream, TextWriter, lub XmlWriter).To deserialize an object from an XML document, create a suitable object to read the document or stream (again, a Stream, TextWriter, or XmlWriter). Wywoływanie Deserialize metody podczas rzutowania wynikowy obiekt na typ oryginalny obiekt (do którego został wydany).Invoke the Deserialize method while casting the resulting object to the type of the original object (that was serialized).

Aby jeszcze bardziej kontrolować serializacji, System.Xml.Serialization przestrzeń nazw zawiera kilka Attribute klas, które mogą być stosowane do członków klasy.To further control the serialization, the System.Xml.Serialization namespace contains several Attribute classes that can be applied to members of a class. Na przykład, jeśli klasa zawiera element członkowski, który będzie serializowana jako XML element, aby stosować XmlElementAttribute atrybutu do elementu członkowskiego.For example, if a class contains a member that will be serialized as an XML element, you can apply the XmlElementAttribute attribute to the member. Stosując atrybut, można określić szczegóły, takie jak rzeczywiste XML elementu nazwy za pomocą ElementName właściwości.When applying the attribute, you can specify details such as the actual XML element name using the ElementName property. Aby uzyskać pełną listę wszystkich atrybutów, zobacz XmlSerializer klasa — Przegląd.For a complete list of all the attributes, see the XmlSerializer class overview.