ContractReference Class
Represents a reference in a discovery document to a service description.
Assembly: System.Web.Services (in System.Web.Services.dll)
XML Web services discovery involves discovering the available Web Services given an URL. The URL usually points to a discovery document, which typically has a.disco file name extension. Within a discovery document are references to information about the existance of XML Web services. These references can refer to service descriptions, XML Schema Definition language (XSD) schemas or other discovery documents. This class represents a reference to a Service Description.
Within a discovery document, a reference to a Service Description is contained within a contractRef XML element. The contractRef XML element has two attributes: ref and docRef. The contractRef element must have an XML namespace matching the Namespace constant, whereas the ref and docRef attributes are placed in the Ref and DocRef properties.
#using <System.Xml.dll> #using <System.Web.Services.dll> using namespace System; using namespace System::Xml; using namespace System::IO; using namespace System::Web::Services::Discovery; int main() { try { // Get a DiscoveryDocument. DiscoveryDocument^ myDiscoveryDocument = gcnew DiscoveryDocument; // Get a ContractReference. ContractReference^ myContractReference = gcnew ContractReference; // Set the URL to the referenced service description. myContractReference->Ref = "http://localhost/service1.asmx?wsdl"; // Set the URL for an XML Web service implementing the service // description. myContractReference->DocRef = "http://localhost/service1.asmx"; SoapBinding^ myBinding = gcnew SoapBinding; myBinding->Binding = gcnew XmlQualifiedName( "q1:Service1Soap" ); myBinding->Address = "http://localhost/service1.asmx"; // Add myContractReference to the list of references contained // in the discovery document. myDiscoveryDocument->References->Add( myContractReference ); // Add Binding to the references collection. myDiscoveryDocument->References->Add( myBinding ); // Open or create a file for writing. FileStream^ myFileStream = gcnew FileStream( "Service1.disco",FileMode::OpenOrCreate,FileAccess::Write ); StreamWriter^ myStreamWriter = gcnew StreamWriter( myFileStream ); // Write myDiscoveryDocument into the passed stream. myDiscoveryDocument->Write( myStreamWriter ); Console::WriteLine( "The Service1.disco is generated." ); } catch ( Exception^ e ) { Console::WriteLine( "Error is {0}", e->Message ); } }
#using <mscorlib.dll>
#using <System.Xml.dll>
#using <System.Web.Services.dll>
using namespace System;
using namespace System::Xml;
using namespace System::IO;
using namespace System::Web::Services::Discovery;
int main() {
try {
// Get a DiscoveryDocument.
DiscoveryDocument* myDiscoveryDocument = new DiscoveryDocument();
// Get a ContractReference.
ContractReference* myContractReference = new ContractReference();
// Set the URL to the referenced service description.
myContractReference->Ref = S"http://localhost/service1.asmx?wsdl";
// Set the URL for an XML Web service implementing the service
// description.
myContractReference->DocRef = S"http://localhost/service1.asmx";
SoapBinding* myBinding = new SoapBinding();
myBinding->Binding = new XmlQualifiedName(S"q1:Service1Soap");
myBinding->Address = S"http://localhost/service1.asmx";
// Add myContractReference to the list of references contained
// in the discovery document.
myDiscoveryDocument->References->Add(myContractReference);
// Add Binding to the references collection.
myDiscoveryDocument->References->Add(myBinding);
// Open or create a file for writing.
FileStream* myFileStream = new FileStream(S"Service1.disco",
FileMode::OpenOrCreate, FileAccess::Write);
StreamWriter* myStreamWriter = new StreamWriter(myFileStream);
// Write myDiscoveryDocument into the passed stream.
myDiscoveryDocument->Write(myStreamWriter);
Console::WriteLine(S"The Service1.disco is generated.");
} catch (Exception* e) {
Console::WriteLine(S"Error is {0}", e->Message);
}
}
System.Web.Services.Discovery::DiscoveryReference
System.Web.Services.Discovery::ContractReference
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.