System.Xml.Serialization 命名空间
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
包含用于将对象序列化为 XML 格式文档或流的类。
类
| 名称 | 说明 |
|---|---|
| CodeExporter |
表示可从数据结构的 XML 表示形式生成代理代码的类。 |
| CodeIdentifier |
提供静态方法,用于将输入文本转换为代码实体的名称。 |
| CodeIdentifiers |
维护由相关代码实体或类型映射生成的一组名称。NET 的 XML 序列化基础结构。 |
| ImportContext |
描述一组架构绑定到 .NET 代码实体的上下文。 |
| SchemaImporter |
描述架构导入程序。 |
| SoapAttributeAttribute |
指定 XmlSerializer 必须将类成员序列化为编码的 SOAP 属性。 |
| SoapAttributeOverrides |
允许在用于 XmlSerializer 将对象序列化或反序列化为编码的 SOAP 时,重写应用于属性、字段和类的属性。 |
| SoapAttributes |
表示控制如何序列化和反序列化 SOAP 方法的属性对象的 XmlSerializer 集合。 |
| SoapCodeExporter |
从 WSDL 文档中定义的 SOAP 编码消息部件的内部类型映射信息生成类型和属性声明。 |
| SoapElementAttribute |
指定由 XmlSerializer 序列化为编码的 SOAP XML 元素的公共成员值。 |
| SoapEnumAttribute |
控制 XmlSerializer 序列化枚举成员的方式。 |
| SoapIgnoreAttribute |
指示 XmlSerializer 不序列化公共字段或公共读/写属性值。 |
| SoapIncludeAttribute |
允许 XmlSerializer 将对象序列化或反序列化为编码的 SOAP XML 时识别类型。 |
| SoapReflectionImporter |
从 .NET 类型或 Web 服务方法信息生成到 SOAP 编码的消息的映射。 |
| SoapSchemaExporter |
XmlSchema使用使用 SOAP 编码序列化的 .NET 类型的 XML 架构数据类型定义填充对象。 |
| SoapSchemaImporter |
在 .NET Framework 中用于为 WSDL 文档中的 SOAP 编码消息部件生成到 .NET 类型的内部映射。 |
| 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 服务描述语言(WSDL)消息中的元素。 |
| XmlMembersMapping |
提供为 SOAP Web 服务定义的 .NET Web 服务方法和 Web 服务描述语言(WSDL)消息之间的映射。 |
| XmlNamespaceDeclarationsAttribute |
指定目标属性、参数、返回值或类成员包含与 XML 文档中使用的命名空间关联的前缀。 |
| XmlNodeEventArgs |
为 UnknownNode 事件提供数据。 |
| XmlReflectionImporter |
为 .NET 类型或 Web 服务方法信息生成到 XML 架构元素声明的映射,包括 Web 服务描述语言(WSDL)文档中的文本 XML 架构定义(XSD)消息部件。 |
| XmlReflectionMember |
提供 .NET Web 服务方法中的代码实体与为 SOAP Web 服务定义的 Web 服务描述语言(WSDL)消息的内容之间的映射。 |
| XmlRootAttribute |
控制属性目标的 XML 序列化,使其作为 XML 根元素。 |
| XmlSchemaEnumerator |
启用对对象集合的 XmlSchema 迭代。 |
| XmlSchemaExporter |
XmlSchema使用在类型映射对象中找到的 XML 架构元素声明填充对象。 |
| XmlSchemaImporter |
为 XML 架构元素声明生成到 .NET 类型的内部映射,包括 WSDL 文档中的文本 XSD 消息部件。 |
| XmlSchemaProviderAttribute |
应用于类型时,存储返回 XML 架构的类型静态方法的名称,以及控制类型序列化的 XmlQualifiedName(或匿名类型的 XmlSchemaType)。 |
| XmlSchemas |
表示 XML 架构的集合。 |
| XmlSerializationGeneratedCode |
一个抽象类,它是其基类 XmlSerializationReader , XmlSerializationWriter 并且包含这两种类型通用的方法。 |
| XmlSerializationReader |
控制类 XmlSerializer 的反序列化。 |
| XmlSerializationReader.CollectionFixup |
XmlSerializationCollectionFixupCallback保存委托实例以及方法的输入;还提供方法的参数。 |
| XmlSerializationReader.Fixup |
XmlSerializationFixupCallback保存委托实例以及方法的输入;还充当该方法的参数。 |
| XmlSerializationWriter |
表示用于控制类序列化的 XmlSerializer 抽象类。 |
| XmlSerializer |
将对象序列化和反序列化到 XML 文档和从 XML 文档反序列化对象。 这使 XmlSerializer 你能够控制如何将对象编码为 XML。 |
| XmlSerializerAssemblyAttribute |
应用于 Web 服务客户端代理后,可以指定包含自定义序列化程序的程序集。 |
| XmlSerializerFactory |
创建类型化版本 XmlSerializer ,以便更高效的序列化。 |
| XmlSerializerImplementation |
定义预生成的类型化序列化程序的读取器、编写器和方法。 |
| XmlSerializerNamespaces |
包含用于在 XML 文档实例中生成限定名称的 XML 命名空间和前缀 XmlSerializer 。 |
| XmlSerializerVersionAttribute |
表示代码是由序列化基础结构生成的,当此属性应用于程序集时,可以重复使用以提高性能。 |
| XmlTextAttribute |
向 XmlSerializer 指示,当包含该成员的类被序列化或反序列化时,该成员必须被视为 XML 文本。 |
| XmlTypeAttribute |
控制由 XmlSerializer序列化属性目标时生成的 XML 架构。 |
| XmlTypeMapping |
包含一种类型到另一种类型的映射。 |
结构
| 名称 | 说明 |
|---|---|
| XmlDeserializationEvents |
包含可用于将事件委托传递给线程安全 Deserialize 方法的 XmlSerializer字段。 |
接口
| 名称 | 说明 |
|---|---|
| IXmlSerializable |
为 XML 序列化和反序列化提供自定义格式。 |
| IXmlTextParser |
Normalized建立可供 .NET 基础结构使用的属性。 |
枚举
| 名称 | 说明 |
|---|---|
| CodeGenerationOptions |
指定生成用于 XML Web 服务的 .NET 类型时要使用的各种选项。 |
| XmlMappingAccess |
指定映射是读、写还是两者。 |
委托
| 名称 | 说明 |
|---|---|
| UnreferencedObjectEventHandler |
表示处理 UnreferencedObject 事件 XmlSerializer的方法。 |
| XmlAttributeEventHandler |
表示处理 .UnknownAttribute |
| XmlElementEventHandler |
表示处理 UnknownElement 事件 XmlSerializer的方法。 |
| XmlNodeEventHandler |
表示处理 UnknownNode 事件 XmlSerializer的方法。 |
| 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 文档反序列化对象,请创建一个合适的对象来读取文档或流(再次、a Stream、 TextWriter或 XmlWriter)。 Deserialize将生成的对象强制转换为原始对象的类型(已序列化)时调用该方法。
为了进一步控制序列化, System.Xml.Serialization 命名空间包含可应用于类成员的多个 Attribute 类。 例如,如果类包含将序列化为 XML 元素的成员,则可以将 XmlElementAttribute 属性应用于该成员。 应用属性时,可以使用属性指定详细信息,例如实际的 XML 元素名称 ElementName 。 有关所有属性的完整列表,请参阅 XmlSerializer 类概述。