System.Xml.Serialization Névtér
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Olyan osztályokat tartalmaz, amelyek az objektumok XML formátumú dokumentumokká vagy streamekké való szerializálására szolgálnak.
Osztályok
| Name | Description |
|---|---|
| CodeExporter |
Olyan osztályt jelöl, amely képes proxykódot létrehozni egy adatstruktúra XML-reprezentációjából. |
| CodeIdentifier |
Statikus metódusokat biztosít a bemeneti szöveg kódentitások nevévé alakításához. |
| CodeIdentifiers |
A .NET XML-szerializálási infrastruktúrája által létrehozott kapcsolódó kódentitások vagy típusleképezések neveinek csoportját tartja fenn. |
| ImportContext |
Azt a környezetet ismerteti, amelyben egy sémakészlet .NET kódentitásokhoz van kötve. |
| SchemaImporter |
Egy sémaimportőrt ismertet. |
| SoapAttributeAttribute |
Megadja, hogy az XmlSerializer osztálytagot kódolt SOAP-attribútumként kell szerializálnia. |
| SoapAttributeOverrides |
Lehetővé teszi a tulajdonságokra, mezőkre és osztályokra alkalmazott attribútumok felülbírálását, amikor kódolt XmlSerializer SOAP-ként szerializál vagy deszerializál egy objektumot. |
| SoapAttributes |
Attribútumobjektumok gyűjteményét jelöli, amelyek szabályozzák, hogy a szerializálja és deszerializálja a XmlSerializer SOAP-metódusokat. |
| SoapCodeExporter |
Típus- és attribútumdeklarációkat hoz létre a WSDL-dokumentumban definiált SOAP kódolású üzenetrészek belső típusleképezési adataiból. |
| SoapElementAttribute |
Megadja, hogy a nyilvános tag értékét kódolt XmlSerializer SOAP XML-elemként szerializálja. |
| SoapEnumAttribute |
XmlSerializer Az enumerálási tag szerializálásának módját szabályozza. |
| SoapIgnoreAttribute |
Utasítja, XmlSerializer hogy ne szerializálja a nyilvános mezőt vagy a nyilvános olvasási/írási tulajdonság értékét. |
| SoapIncludeAttribute |
Lehetővé teszi egy XmlSerializer típus felismerését, amikor szerializál vagy deszerializál egy objektumot kódolt SOAP XML-fájlként. |
| SoapReflectionImporter |
Megfeleltetést hoz létre a SOAP kódolású üzenetekhez .NET típusok vagy webszolgáltatás-metódus adatai alapján. |
| SoapSchemaExporter |
A SOAP-kódolással szerializált .NET XmlSchema objektumokat tölti fel XML-séma adattípus-definíciókkal. |
| SoapSchemaImporter |
A .NET-keretrendszerben a WSDL-dokumentumok SOAP-kódolású üzenetrészeinek .NET típusú belső leképezések létrehozására szolgál. |
| SoapSchemaMember |
Egy WSDL-dokumentumban lévő XSD-elem < |
| SoapTypeAttribute |
Az osztálypéldány SOAP kódolású XML-fájlként való szerializálása során XmlSerializer létrehozott sémát szabályozza. |
| UnreferencedObjectEventArgs |
Adatokat biztosít a kódolt SOAP XML-adatfolyamban a deszerializálás során talált ismert, de nem hivatkozott objektumhoz. |
| XmlAnyAttributeAttribute |
Megadja, hogy a tag (egy objektumtömböt XmlAttribute visszaadó mező) bármilyen XML-attribútumot tartalmazhat. |
| XmlAnyElementAttribute |
Megadja, hogy a tag (egy tömböt vagy XmlElement objektumot visszaadó XmlNode mező) olyan objektumokat tartalmaz, amelyek olyan XML-elemet képviselnek, amelynek nincs megfelelő tagja a szerializált vagy deszerializált objektumban. |
| XmlAnyElementAttributes |
Objektumok gyűjteményét XmlAnyElementAttribute jelöli. |
| XmlArrayAttribute |
Megadja, hogy az XmlSerializer adott osztálytagot XML-elemek tömbjeként kell szerializálnia. |
| XmlArrayItemAttribute |
Olyan attribútumot jelöl, amely meghatározza a szerializált tömbben elhelyezhető származtatott típusokat XmlSerializer . |
| XmlArrayItemAttributes |
Objektumok gyűjteményét XmlArrayItemAttribute jelöli. |
| XmlAttributeAttribute |
Megadja, hogy az XmlSerializer osztálytagot XML-attribútumként kell szerializálnia. |
| XmlAttributeEventArgs |
Adatokat biztosít az UnknownAttribute eseményhez. |
| XmlAttributeOverrides |
Lehetővé teszi a tulajdonság-, mező- és osztályattribútumok felülbírálását egy XmlSerializer objektum szerializálása vagy deszerializálása során. |
| XmlAttributes |
Attribútumobjektumok gyűjteményét jelöli, amelyek szabályozzák, XmlSerializer hogyan szerializálja és deszerializálja az objektumokat. |
| XmlChoiceIdentifierAttribute |
Megadja, hogy a tag enumerálással tovább észlelhető legyen. |
| XmlCodeExporter |
Típus- és attribútumdeklarációkat hoz létre az XML-sémaelem-deklarációk belső típusleképezési adataiból. |
| XmlElementAttribute |
Azt jelzi, hogy egy nyilvános mező vagy tulajdonság egy XML-elemet jelöl, amikor a XmlSerializer szerializálja vagy deszerializálja az azt tartalmazó objektumot. |
| XmlElementAttributes |
Az osztály alapértelmezett szerializálási módjának felülbírálásához használt XmlElementAttribute objektumok gyűjteményét XmlSerializer jelöli. |
| XmlElementEventArgs |
Adatokat biztosít az UnknownElement eseményhez. |
| XmlEnumAttribute |
XmlSerializer Az enumerálási tag szerializálásának módját szabályozza. |
| XmlIgnoreAttribute |
Arra utasítja a Serialize(TextWriter, Object)XmlSerializer metódust, hogy ne szerializálja a nyilvános mezőt vagy a nyilvános olvasási/írási tulajdonság értékét. |
| XmlIncludeAttribute |
Lehetővé teszi egy XmlSerializer típus felismerését, amikor szerializál vagy deszerializál egy objektumot. |
| XmlMapping |
Támogatja a .NET és az XML-séma adattípusai közötti leképezéseket. |
| XmlMemberMapping |
Egy .NET webszolgáltatás-metódus kódentitását egy Web Services Description Language (WSDL) üzenet egyik elemére képezi le. |
| XmlMembersMapping |
Megfeleltetést biztosít .NET webszolgáltatás-metódusok és a SOAP-webszolgáltatásokhoz definiált Web Services Description Language (WSDL) üzenetek között. |
| XmlNamespaceDeclarationsAttribute |
Megadja, hogy a céltulajdonság, paraméter, visszatérési érték vagy osztálytag tartalmaz-e az XML-dokumentumban használt névterekhez társított előtagokat. |
| XmlNodeEventArgs |
Adatokat biztosít az UnknownNode eseményhez. |
| XmlReflectionImporter |
Megfeleltetéseket hoz létre XML-sémaelem-deklarációkhoz, beleértve a konstans XML-sémadefiníciós (XSD) üzenetrészeket egy Web Services Description Language (WSDL) dokumentumban .NET típusok vagy webszolgáltatás-metódusok adataihoz. |
| XmlReflectionMember |
Megfeleltetést biztosít .NET webszolgáltatás-metódusok kódentitásai és a SOAP-webszolgáltatásokhoz definiált Web Services Description Language (WSDL) üzenetek tartalma között. |
| XmlRootAttribute |
Az attribútum-cél XML-szerializálását szabályozza XML-gyökérelemként. |
| XmlSchemaEnumerator |
Lehetővé teszi az objektumgyűjtemények iterációját XmlSchema . |
| XmlSchemaExporter |
XmlSchema A típusleképezési objektumokban található XML-sémaelem-deklarációkkal tölti fel az objektumokat. |
| XmlSchemaImporter |
Belső leképezéseket hoz létre .NET XML-sémaelem-deklarációkhoz, beleértve a WSDL-dokumentumok literális XSD-üzenetrészeit is. |
| XmlSchemaProviderAttribute |
Egy típusra alkalmazva tárolja annak a típusnak a statikus metódusát, amely egy XML-sémát és egy XmlQualifiedName (vagy XmlSchemaType névtelen) típust ad vissza, amely vezérli a típus szerializálását. |
| XmlSchemas |
AZ XML-sémák gyűjteményét jelöli. |
| XmlSerializationGeneratedCode |
Egy absztrakt osztály, amely az alaposztály XmlSerializationReader , és XmlSerializationWriter amely mindkét típushoz közös metódusokat tartalmaz. |
| XmlSerializationReader |
Szabályozza az osztály által történő deszerializálást XmlSerializer . |
| XmlSerializationReader.CollectionFixup |
Egy delegált példányt XmlSerializationCollectionFixupCallback és a metódus bemeneteit tartalmazza; a metódus paramétereit is tartalmazza. |
| XmlSerializationReader.Fixup |
Delegált példányt XmlSerializationFixupCallback tartalmaz, valamint a metódus bemeneteit; a metódus paramétereként is szolgál. |
| XmlSerializationWriter |
Az osztály szerializálásának XmlSerializer szabályozásához használt absztrakt osztályt jelöli. |
| XmlSerializer |
Szerializálja és deszerializálja az objektumokat XML-dokumentumokba és azokból. Ez XmlSerializer lehetővé teszi az objektumok XML-kódolásának szabályozását. |
| XmlSerializerAssemblyAttribute |
Webszolgáltatás-ügyfélproxyra alkalmazva egyéni szerializálókat tartalmazó szerelvényt adhat meg. |
| XmlSerializerFactory |
A hatékonyabb szerializálás érdekében létrehozza a XmlSerializer gépelt verziókat. |
| XmlSerializerImplementation |
Meghatározza az előre létrehozott, gépelt szerializálók olvasóit, íróit és metódusait. |
| XmlSerializerNamespaces |
Tartalmazza azOKAT az XML-névtereket és előtagokat, amelyekkel XmlSerializer minősített neveket hozhat létre egy XML-dokumentumpéldányban. |
| XmlSerializerVersionAttribute |
Azt jelzi, hogy a kódot a szerializálási infrastruktúra hozta létre, és a nagyobb teljesítmény érdekében újra felhasználható, ha ezt az attribútumot egy szerelvényre alkalmazza a rendszer. |
| XmlTextAttribute |
Azt jelzi, XmlSerializer hogy a tagot XML-szövegként kell kezelni, ha az azt tartalmazó osztály szerializált vagy deszerializált. |
| XmlTypeAttribute |
Az attribútum-cél szerializálásakor létrehozott XML-sémát szabályozza.XmlSerializer |
| XmlTypeMapping |
Egy típus egy másikhoz való leképezését tartalmazza. |
Struktúrák
| Name | Description |
|---|---|
| XmlDeserializationEvents |
Olyan mezőket tartalmaz, amelyek segítségével az eseménydelegáltak átadhatók a szálbiztos Deserialize metódusnak.XmlSerializer |
Interfészek
| Name | Description |
|---|---|
| IXmlSerializable |
Egyéni formázást biztosít az XML-szerializáláshoz és a deszerializáláshoz. |
| IXmlTextParser |
Létrehoz egy Normalized tulajdonságot a .NET infrastruktúra számára. |
Enumerációk
| Name | Description |
|---|---|
| CodeGenerationOptions |
Az XML Web Service-hez használható .NET-típusok létrehozásakor használandó különböző beállításokat adja meg. |
| XmlMappingAccess |
Megadja, hogy a leképezés olvasási, írási vagy mindkettő legyen-e. |
Delegáltak
| Name | Description |
|---|---|
| UnreferencedObjectEventHandler |
Az eseményt UnreferencedObject kezelő metódust XmlSerializerjelöli. |
| XmlAttributeEventHandler |
Azt a metódust jelöli, amely a UnknownAttribute. |
| XmlElementEventHandler |
Az eseményt UnknownElement kezelő metódust XmlSerializerjelöli. |
| XmlNodeEventHandler |
Az eseményt UnknownNode kezelő metódust XmlSerializerjelöli. |
| XmlSerializationCollectionFixupCallback |
Az osztály által a XmlSerializer gyűjteményekre vagy enumerálásokra leképezett SOAP-kódolt XML-adattípusok deszerializálásához használt delegálás. |
| XmlSerializationFixupCallback |
A SOAP-kódolású XmlSerializer XML-adatok deszerializálásához használt delegált. |
| XmlSerializationReadCallback |
Az osztály által a XmlSerializer SOAP kódolású, nem gyökérszintű XML-adatokból származó típusok deszerializálásához használt delegálás. |
| XmlSerializationWriteCallback |
Delegált, amelyet az osztály használ a XmlSerializer SOAP kódolású, nem gyökérszintű XML-adatokból származó típusok szerializálásához. |
Megjegyzések
A névtér központi osztálya az XmlSerializer osztály. Az osztály használatához a XmlSerializer konstruktor használatával hozza létre az osztály egy példányát a szerializálni kívánt objektum típusával. XmlSerializer A létrehozás után hozzon létre egy példányt az objektumból, amelyet szerializálni szeretne. Létre kell hoznia egy objektumot is a fájl dokumentumba vagy streambe való írásához, például egy Stream, TextWritervagy XmlWriter. Ezután meghívhatja a metódust az Serialize objektum XML-dokumentummá alakításához.
Ha xml-dokumentumból szeretne deszerializálni egy objektumot, hozzon létre egy megfelelő objektumot a dokumentum vagy a stream olvasásához (ismét egy Stream, TextWritervagy XmlWriter). Hívja meg a Deserialize metódust, miközben az eredményként kapott objektumot az eredeti objektum típusára (szerializált) adhatja meg.
A szerializálás további szabályozásához a System.Xml.Serialization névtér több Attribute osztályt tartalmaz, amelyek egy osztály tagjaira alkalmazhatók. Ha például egy osztály tartalmaz egy XML-elemként szerializált tagot, alkalmazhatja az XmlElementAttribute attribútumot a tagra. Az attribútum alkalmazásakor megadhatja az olyan részleteket, mint a tényleges XML-elem neve a ElementName tulajdonság használatával. Az összes attribútum teljes listájáért tekintse meg az XmlSerializer osztály áttekintését.