ContractReference Klasse

Referenz

Definition

Namespace:: System.Web.Services.Discovery

Assembly:: System.Web.Services.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt einen Verweis auf eine Dienstbeschreibung in einem Discoverydokument dar.

public ref class ContractReference : System::Web::Services::Discovery::DiscoveryReference

public class ContractReference : System.Web.Services.Discovery.DiscoveryReference

type ContractReference = class
    inherit DiscoveryReference

Public Class ContractReference
Inherits DiscoveryReference

Vererbung: Object

DiscoveryReference
ContractReference

Beispiele

#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 System;
using System.Xml;
using System.IO;
using System.Web.Services.Discovery;

public class MyContractReference
{
   static void 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 = "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 = new SoapBinding();
         myBinding.Binding = new 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 = new FileStream("Service1.disco",
             FileMode.OpenOrCreate, FileAccess.Write );
         StreamWriter myStreamWriter = new 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 "+ e.Message);
      }
   }
}

Imports System.Xml
Imports System.IO
Imports System.Web.Services.Discovery

Public Class MyContractReference
   Shared Sub Main()
      Try
         ' Get a 'DiscoveryDocument' object.
         Dim myDiscoveryDocument As New DiscoveryDocument()
         ' Get a 'ContractReference' object.
         Dim myContractReference As New ContractReference()
         ' Set the URL to the referenced service description.
         myContractReference.Ref = "http://localhost/service1.asmx?wsdl"
         ' Set the URL for a XML Web service implementing the service
         ' description .
         myContractReference.DocRef = "http://localhost/service1.asmx"
         Dim myBinding As New SoapBinding()
         myBinding.Binding = New XmlQualifiedName("q1:Service1Soap")
         myBinding.Address = "http://localhost/service1.asmx"
         ' Add 'myContractReference' to the list of references contained 
         ' within the discovery document.
         myDiscoveryDocument.References.Add(myContractReference)
         ' Add 'Binding' to referenceCollection.
         myDiscoveryDocument.References.Add(myBinding)
         ' Open or create a file for writing .
         Dim myFileStream As New FileStream("Service1.disco", FileMode.OpenOrCreate, FileAccess.Write)
         Dim myStreamWriter As New StreamWriter(myFileStream)
         ' Write 'myDiscoveryDocument' into the passed stream.
         myDiscoveryDocument.Write(myStreamWriter)
         Console.WriteLine("The 'Service1.disco' is generated.")
      Catch e As Exception
         Console.WriteLine("Error is" + e.Message)
      End Try
   End Sub
End Class

Hinweise

Bei der XML-Webdienstermittlung werden die verfügbaren Webdienste anhand einer URL ermittelt. Die URL verweist in der Regel auf ein Ermittlungsdokument, das in der Regel über die Dateinamenerweiterung .disco verfügt. Innerhalb eines Ermittlungsdokuments sind Verweise auf Informationen über das Vorhandensein von XML-Webdiensten enthalten. Diese Verweise können auf Dienstbeschreibungen, XSD-Schemaschemas (XML Schema Definition Language) oder andere Ermittlungsdokumente verweisen. Diese Klasse stellt einen Verweis auf eine Dienstbeschreibung dar.

In einem Ermittlungsdokument ist ein Verweis auf eine Dienstbeschreibung in einem contractRef XML-Element enthalten. Das contractRef XML-Element verfügt über zwei Attribute: ref und docRef. Das contractRef Element muss über einen XML-Namespace verfügen, der der Namespace Konstanten entspricht, während die ref Attribute und docRef in den Ref Eigenschaften und DocRef platziert werden.

Konstruktoren

ContractReference()	Initialisiert eine neue Instanz der ContractReference-Klasse unter Verwendung von Standardwerten.
ContractReference(String)	Initialisiert eine neue Instanz der ContractReference-Klasse unter Verwendung des angegebenen Verweises auf eine Dienstbeschreibung.
ContractReference(String, String)	Initialisiert eine neue Instanz der ContractReference-Klasse unter Verwendung der angegebenen Verweise auf eine Dienstbeschreibung und einen XML-Webdienst, der die Dienstbeschreibung implementiert.

Felder

Namespace

XML-Namespace für Verweise auf Dienstbeschreibungen in Discoverydokumenten.

Eigenschaften

ClientProtocol	Ruft die Instanz von DiscoveryClientProtocol ab, die in einem Discoveryvorgang verwendet wird, oder legt diese fest. (Geerbt von DiscoveryReference)
Contract	Ruft ein ServiceDescription-Objekt ab, das die Dienstbeschreibung darstellt.
DefaultFilename	Ruft den Namen der Datei ab, die beim Speichern der Dienstbeschreibung, auf die verwiesen wird, als Standard verwendet werden soll.
DocRef	Ruft die URL für einen XML-Webdienst ab, der die Dienstbeschreibung implementiert, auf die in der Ref-Eigenschaft verwiesen wird, oder legt diese URL fest.
Ref	Ruft die URL für die Dienstbeschreibung ab, auf die verwiesen wird, oder legt diese fest.
Url	Ruft die URL für die Dienstbeschreibung ab, auf die verwiesen wird, oder legt diesen fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ReadDocument(Stream)	Liest die Dienstbeschreibung aus dem übergebenen Stream und gibt die Dienstbeschreibung zurück.
Resolve()	Lädt das Dokument herunter, auf das verwiesen wird, unter Url, um seine Gültigkeit zu überprüfen. (Geerbt von DiscoveryReference)
Resolve(String, Stream)	Überprüft die Gültigkeit des Dokuments, auf das verwiesen wird.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
WriteDocument(Object, Stream)	Schreibt die übergebene Dienstbeschreibung in den übergebenen Stream.

Gilt für: