System.Runtime.Serialization.XsdDataContractExporter, klasa

Ten artykuł zawiera dodatkowe uwagi dotyczące dokumentacji referencyjnej dla tego interfejsu API.

XsdDataContractExporter Użyj klasy podczas tworzenia usługi sieci Web, która zawiera dane reprezentowane przez typy środowiska uruchomieniowego języka wspólnego (CLR) i kiedy należy wyeksportować schematy XML dla każdego typu, które mają być używane przez inne usługi sieci Web. Oznacza to, że XsdDataContractExporter przekształca zestaw typów CLR w schematy XML. (Aby uzyskać więcej informacji na temat typów, których można użyć, zobacz Typy obsługiwane przez serializator kontraktu danych). Schematy można następnie uwidocznić za pomocą dokumentu WSDL (Web Services Description Language) do użytku przez inne osoby, które muszą współpracować z usługą.

Z drugiej strony, jeśli tworzysz usługę sieci Web, która musi współdziałać z istniejącą usługą sieci Web, użyj polecenia XsdDataContractImporter , aby przekształcić schematy XML i utworzyć typy CLR reprezentujące dane w wybranym języku programowania.

Obiekt XsdDataContractExporter generuje XmlSchemaSet obiekt zawierający kolekcję schematów. Uzyskaj dostęp do zestawu schematów za pośrednictwem Schemas() właściwości .

Uwaga

Aby szybko wygenerować pliki definicji schematu XML (XSD), z których mogą korzystać inne usługi sieci Web, użyj polecenia XsdDataContractExporter.

Eksportowanie schematów do zestawu XmlSchemaSet

Aby utworzyć wystąpienie XmlSchemaSet klasy zawierającej pliki schematu XML, należy pamiętać o następujących kwestiach.

Zestaw eksportowanych typów jest rejestrowany jako wewnętrzny zestaw kontraktów danych. W związku z tym można wywołać metodę CanExport wiele razy, aby dodać nowe typy do zestawu schematów bez obniżenia wydajności, ponieważ tylko nowe typy zostaną dodane do zestawu. Export Podczas operacji istniejące schematy są porównywane z dodanymi nowymi schematami. Jeśli wystąpią konflikty, zostanie zgłoszony wyjątek. Konflikt jest zwykle wykrywany, jeśli dwa typy o tej samej nazwie kontraktu danych, ale różne kontrakty (różne elementy członkowskie) są eksportowane przez to samo XsdDataContractExporter wystąpienie.

Korzystanie z eksportera

Zalecanym sposobem korzystania z tej klasy jest następująca:

1. Użyj jednego z CanExport przeciążeń, aby określić, czy można wyeksportować określony typ lub zestaw typów. Użyj jednego z przeciążeń, które są odpowiednie dla Twoich wymagań.

2. Wywołaj odpowiednią Export metodę.

3. Pobierz schematy z Schemas właściwości .