Sdílet prostřednictvím

System.Runtime.Serialization.XsdDataContractExporter – třída

  • Článek

Tento článek obsahuje doplňující poznámky k referenční dokumentaci pro toto rozhraní API.

XsdDataContractExporter Třídu použijte, když jste vytvořili webovou službu, která zahrnuje data reprezentovaná typy CLR (Common Language Runtime) a kdy potřebujete exportovat schémata XML pro každý typ, který budou využívat jiné webové služby. To znamená, XsdDataContractExporter transformuje sadu typů CLR na schémata XML. (Další informace o typech, které lze použít, najdete v tématu Typy podporované serializátorem kontraktu dat.) Schémata je pak možné zpřístupnit prostřednictvím dokumentu WSDL (Web Services Description Language) pro použití jinými uživateli, kteří potřebují spolupracovat s vaší službou.

Naopak pokud vytváříte webovou službu, která musí spolupracovat s existující webovou službou, použijte XsdDataContractImporter k transformaci schémat XML a vytvoření typů CLR, které představují data ve vybraném programovacím jazyce.

Vygeneruje XsdDataContractExporterXmlSchemaSet objekt, který obsahuje kolekci schémat. Přístup k sadě schémat prostřednictvím Schemas() vlastnosti.

Poznámka:

Chcete-li rychle generovat soubory definice schématu XML (XSD), které mohou využívat jiné webové služby, použijte XsdDataContractExporter.

Export schémat do XmlSchemaSet

Chcete-li vytvořit instanci XmlSchemaSet třídy, která obsahuje soubory schématu XML, měli byste mít na paměti následující.

Sada typů, které exportujete, se zaznamenávají jako interní sada kontraktů dat. Proto můžete metodu CanExport volat vícekrát, chcete-li přidat nové typy do sady schématu bez snížení výkonu, protože do sady budou přidány pouze nové typy. Export Během operace se existující schémata porovnávají s přidanou novou schématou. Pokud dojde ke konfliktům, vyvolá se výjimka. Konflikt je obvykle zjištěn, pokud jsou dva typy se stejným názvem kontraktu dat, ale různé kontrakty (různé členy) jsou exportovány stejnou XsdDataContractExporter instancí.

Použití vývozce

Doporučený způsob použití této třídy je následující:

  1. Pomocí jednoho z CanExport přetížení určete, zda je možné exportovat zadaný typ nebo sadu typů. Použijte jedno z přetížení, které je vhodné pro vaše požadavky.

  2. Zavolejte odpovídající Export metodu.

  3. Načtěte schémata z Schemas vlastnosti.