System.Xml.Serialization 命名空间
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
包含用于将对象序列化为 XML 格式的文档或流的类。
类
CodeExporter |
表示一个类,该类可从数据结构的 XML 表示形式生成代理代码。 |
CodeIdentifier |
提供一些静态方法,用于将输入文本转换为代码实体的名称。 |
CodeIdentifiers |
维护相关代码实体或类型映射的一组名称,这些名称是 .NET 的 XML 序列化基础结构生成的。 |
ImportContext |
描述特定上下文,架构集在该上下文中绑定到 .NET 代码实体。 |
SchemaImporter |
描述架构导入程序。 |
SoapAttributeAttribute |
指定 XmlSerializer 必须将类成员序列化为编码的 SOAP 特性。 |
SoapAttributeOverrides |
允许您在使用 XmlSerializer 将对象序列化或反序列化为编码的 SOAP 时重写应用于属性、字段和类的特性。 |
SoapAttributes |
表示特性对象的集合,这些对象控制 XmlSerializer 如何序列化和反序列化 SOAP 方法。 |
SoapCodeExporter |
从 WSDL 文档中定义的 SOAP 编码的消息部分的内部类型映射信息生成类型和特性声明。 |
SoapElementAttribute |
指定公共成员值由 XmlSerializer 序列化为经过编码的 SOAP XML 元素。 |
SoapEnumAttribute |
控制 XmlSerializer 如何序列化枚举成员。 |
SoapIgnoreAttribute |
指示 XmlSerializer 不序列化公共字段或公共读/写属性值。 |
SoapIncludeAttribute |
允许 XmlSerializer 在将对象序列化或反序列化为编码的 SOAP XML 时识别类型。 |
SoapReflectionImporter |
从 .NET 类型或 Web 服务方法信息生成到 SOAP 编码的消息的映射。 |
SoapSchemaExporter |
使用 .NET Framework 类型的 XML 架构数据类型定义填充 XmlSchema 对象,该 .NET Framework 类型是用 SOAP 编码串行化的。 |
SoapSchemaImporter |
在 .NET Framework 内使用来为 WSDL 文档中 SOAP 编码的消息部分生成到 .NET Framework 类型的内部映射。 |
SoapSchemaMember |
表示 WSDL 文档中 XSD < |
SoapTypeAttribute |
将类实例序列化为 SOAP 编码的 XML 时,控制 XmlSerializer 生成的架构。 |
UnreferencedObjectEventArgs |
在反序列化期间,为在编码的 SOAP XML 流中找到的已知的(但未引用的)对象提供数据。 |
XmlAnyAttributeAttribute |
指定成员(返回 XmlAttribute 对象的数组的字段)可以包含任何 XML 特性。 |
XmlAnyElementAttribute |
指定成员(返回 XmlElement 或 XmlNode 对象的数组的字段)可以包含对象,该对象表示在序列化或反序列化的对象中没有相应成员的所有 XML 元素。 |
XmlAnyElementAttributes |
表示 XmlAnyElementAttribute 对象集合。 |
XmlArrayAttribute |
指定 XmlSerializer 必须将特定的类成员序列化为 XML 元素的数组。 |
XmlArrayItemAttribute |
表示指定 XmlSerializer 可以放置在序列化数组中的派生类型的特性。 |
XmlArrayItemAttributes |
表示 XmlArrayItemAttribute 对象集合。 |
XmlAttributeAttribute |
指定 XmlSerializer 必须将类成员序列化为 XML 属性。 |
XmlAttributeEventArgs |
为 UnknownAttribute 事件提供数据。 |
XmlAttributeOverrides |
允许在使用 XmlSerializer 串行化或反序列化对象时替代属性、字段和类特性。 |
XmlAttributes |
表示控制 XmlSerializer 串行化和反序列化对象方式的属性对象的集合。 |
XmlChoiceIdentifierAttribute |
指定可以使用枚举进一步检测成员。 |
XmlCodeExporter |
从 XML 架构元素声明的内部类型映射信息生成类型和特性声明。 |
XmlElementAttribute |
指示公共字段或属性在 XmlSerializer 序列化或反序列化包含它们的对象时表示 XML 元素。 |
XmlElementAttributes |
表示 XmlSerializer 用于重写其序列化类的默认方式的 XmlElementAttribute 对象的集合。 |
XmlElementEventArgs |
为 UnknownElement 事件提供数据。 |
XmlEnumAttribute |
控制 XmlSerializer 如何序列化枚举成员。 |
XmlIgnoreAttribute |
指示 Serialize(TextWriter, Object) 的 XmlSerializer 方法不序列化公共字段或公共读/写属性值。 |
XmlIncludeAttribute |
允许 XmlSerializer 在它序列化或反序列化对象时识别类型。 |
XmlMapping |
支持 .NET 类型和 XML 架构数据类型之间的映射。 |
XmlMemberMapping |
将 .NET Web 服务方法中的代码实体映射到 Web Services 描述语言 (WSDL) 消息中的元素。 |
XmlMembersMapping |
提供 .NET Web 服务方法与为 SOAP Web 服务定义的 Web Services 描述语言 (WSDL) 消息之间的映射。 |
XmlNamespaceDeclarationsAttribute |
指定目标属性、参数、返回值或类成员包含与 XML 文档中使用的命名空间相关联的前缀。 |
XmlNodeEventArgs |
为 UnknownNode 事件提供数据。 |
XmlReflectionImporter |
为 .NET 类型或 Web 服务方法信息生成到 XML 架构元素声明(包括 Web 服务描述语言 (WSDL) 文档中的文本 XML 架构定义 (XSD) 消息部分)的映射。 |
XmlReflectionMember |
提供 .NET Web 服务方法中的代码实体与为 SOAP Web 服务定义的 Web Services 描述语言 (WSDL) 消息的内容之间的映射。 |
XmlRootAttribute |
控制视为 XML 根元素的属性目标的 XML 序列化。 |
XmlSchemaEnumerator |
允许对 XmlSchema 对象集合进行迭代。 |
XmlSchemaExporter |
使用类型映射对象中的 XML 架构元素声明填充 XmlSchema 对象。 |
XmlSchemaImporter |
为 XML 架构元素声明(包括 WSDL 文档中的文本 XSD 消息部件)生成到 .NET 类型的内部映射。 |
XmlSchemaProviderAttribute |
应用于某个类型时,存储返回 XML 架构的该类型静态方法的名称和控制该类型序列化的 XmlQualifiedName(对于匿名类型,为 XmlSchemaType)。 |
XmlSchemas |
表示 XML 架构的集合。 |
XmlSerializationGeneratedCode |
一个抽象类,该类是 XmlSerializationReader 和 XmlSerializationWriter 以及包含这两种类型的通用方法的那些类型的基类。 |
XmlSerializationReader |
控制由 XmlSerializer 类执行的反序列化。 |
XmlSerializationReader.CollectionFixup |
保存 XmlSerializationCollectionFixupCallback 委托实例和方法的输入;还提供方法的参数。 |
XmlSerializationReader.Fixup |
保存 XmlSerializationFixupCallback 委托实例,以及该方法的输入;也作为该方法的参数使用。 |
XmlSerializationWriter |
表示抽象类,用于控制由 XmlSerializer 类执行的序列化。 |
XmlSerializer |
在对象和 XML 文档之间进行序列化和反序列化操作。 XmlSerializer 使您得以控制如何将对象编码到 XML 中。 |
XmlSerializerAssemblyAttribute |
应用于 Web 服务客户端代理,可用来指定包含自定义序列化程序的程序集。 |
XmlSerializerFactory |
创建 XmlSerializer 的类型化版本,以使序列化更为有效。 |
XmlSerializerImplementation |
为预生成的类型化序列化程序定义读取器、编写器和方法。 |
XmlSerializerNamespaces |
包含 XmlSerializer 用于在 XML 文档实例中生成限定名的 XML 命名空间和前缀。 |
XmlSerializerVersionAttribute |
表示代码是由序列化基础结构生成的,向程序集应用此特性时,可重复使用以提高性能。 |
XmlTextAttribute |
当串行化或反序列化包含该成员的类时,向 XmlSerializer 指示应将该成员作为 XML 文本处理。 |
XmlTypeAttribute |
控制当属性目标由 XmlSerializer 序列化时生成的 XML 架构。 |
XmlTypeMapping |
包含从一种类型到另一种类型的映射。 |
结构
XmlDeserializationEvents |
包含可用于将事件委托传递给 Deserialize 的线程安全的 XmlSerializer 方法的字段。 |
接口
IXmlSerializable |
为 XML 序列化和反序列化提供自定义格式。 |
IXmlTextParser |
建立一个 Normalized 属性供 .NET 基础结构使用。 |
枚举
CodeGenerationOptions |
指定在生成用于 XML Web services 的 .NET 类型时使用的各种选项。 |
XmlMappingAccess |
指定映射是读取、写入,还是既读取又写入。 |
委托
UnreferencedObjectEventHandler |
表示处理 XmlSerializer 的 UnreferencedObject 事件的方法。 |
XmlAttributeEventHandler |
表示处理 UnknownAttribute 的方法。 |
XmlElementEventHandler |
表示处理 XmlSerializer 的 UnknownElement 事件的方法。 |
XmlNodeEventHandler |
表示处理 XmlSerializer 的 UnknownNode 事件的方法。 |
XmlSerializationCollectionFixupCallback |
XmlSerializer 类用于对映射到集合或枚举的 SOAP 编码的 XML 数据类型进行反序列化的委托。 |
XmlSerializationFixupCallback |
XmlSerializer 类用来反序列化 SOAP 编码的 XML 数据的委托。 |
XmlSerializationReadCallback |
XmlSerializer 类为了对 SOAP 编码的非根 XML 数据的类型进行反序列化而使用的委托。 |
XmlSerializationWriteCallback |
XmlSerializer 类为了对 SOAP 编码的非根 XML 数据的类型进行序列化而使用的委托。 |
注解
命名空间中的中心类是 XmlSerializer 类。 若要使用此类,请使用 XmlSerializer 构造函数使用要序列化的对象的类型创建 类的实例。 XmlSerializer创建 后,创建要序列化的 对象的实例。 还必须创建对象才能将文件写入文档或流,例如 Stream、 TextWriter或 XmlWriter。 然后,可以调用 Serialize 方法将 对象转换为 XML 文档。
若要从 XML 文档中反序列化对象,请创建一个合适的对象,以便再次读取文档或流 (、 Stream、 TextWriter或 XmlWriter) 。 Deserialize调用 方法,同时将生成的 对象强制转换为) 序列化的原始对象 (的类型。
为了进一步控制序列化, System.Xml.Serialization 命名空间包含多个 Attribute 可应用于类成员的类。 例如,如果类包含将序列化为 XML 元素的成员,则可以将 XmlElementAttribute 特性应用于该成员。 应用 特性时,可以使用 属性指定详细信息,例如实际的 XML 元素名称 ElementName 。 有关所有属性的完整列表,请参阅 XmlSerializer 类概述。