MetadataSection Class


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Represents XML metadata or references to XML metadata.

Namespace:   System.ServiceModel.Description
Assembly:  System.ServiceModel (in System.ServiceModel.dll)


public class MetadataSection


Initializes a new instance of the MetadataSection class with no dialect, identifier, or XML metadata.

System_CAPS_pubmethodMetadataSection(String, String, Object)

Initializes a new instance of the MetadataSection class using the specified dialect, identifier, and XML metadata.


Gets a collection of XML attributes that you can use to add or remove attributes extensions to the metadata.


Gets or sets a value that indicates the type of metadata.


Gets or sets an identifier for the metadata.


Gets or sets the contained metadata object.


Contains the value of the metadata exchange dialect.


Contains the value of the WS-Policy dialect.


Contains the value of the Web Services Description Language (WSDL) dialect.


Contains the value of the XML Schema dialect.

System_CAPS_pubmethodSystem_CAPS_staticCreateFromPolicy(XmlElement, String)

Creates a MetadataSection from the specified policy information.


Creates a MetadataSection from the specified System.Xml.Schema.XmlSchema object.


Returns a MetadataSection that contains the specified System.Web.Services.Description.ServiceDescription.


Determines whether the specified object is equal to the current object.(Inherited from Object.)


Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)


Serves as the default hash function. (Inherited from Object.)


Gets the Type of the current instance.(Inherited from Object.)


Creates a shallow copy of the current Object.(Inherited from Object.)


Returns a string that represents the current object.(Inherited from Object.)

The MetadataSection class conforms to the definition of the wsx:Metadata/wsx:MetadataSection element in the WS-Metadata Exchange specification and contains XML metadata or references to XML metadata.

A MetadataSection object contains one dialect of metadata in XML form (such as a Web Services Description Language or WSDL file). You can add a MetadataSection to a collection of XML metadata represented by a MetadataSet object. Much of the Windows Communication Foundation (WCF) metadata system, such as the MetadataExchangeClient class, use the MetadataSet class to import or export service metadata in XML form.

For example, to export WCF contract or endpoint objects to a MetadataSet object that contains the equivalent metadata in XML form, call the appropriate Export methods on the WsdlExporter class, passing either ContractDescription or ServiceEndpoint objects, and then call the GetGeneratedMetadata method.

To import XML-based metadata from a MetadataSet object into WCFContractDescription, ServiceEndpoint, and Binding objects, pass a MetadataSet object to the constructor of the WsdlImporter class and call one of the import methods.

The following code example shows how to retrieve the MetadataSection objects from a System.ServiceModel.Description.MetadataResolver and iterate through them to write the Identifier and Dialect properties to the console.

// Get metadata documents.
Console.WriteLine("URI of the metadata documents retreived:");
MetadataExchangeClient metaTransfer 
  = new MetadataExchangeClient(httpGetMetaAddress.Uri, MetadataExchangeClientMode.HttpGet);
metaTransfer.ResolveMetadataReferences = true;
MetadataSet otherDocs = metaTransfer.GetMetadata();
foreach (MetadataSection doc in otherDocs.MetadataSections)
  Console.WriteLine(doc.Dialect + " : " + doc.Identifier);

.NET Framework
Available since 3.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top